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Introduction 


Sinclair ZX Spectrum +3 

128K Integrated Home Computer/Disk System 

Following on from the outstanding success of the established ZX range of computers: the original 
Spectrum, the Spectrum +, the Spectrum 128 and the new generation Spectrum +2, we now proudly 
present the ZX Spectrum +3, a machine that combines the very best features of the previous Sinclair 
models, with the added convenience of a fast access floppy disk drive. 

The whole is a truly complete computer/disk system which allies established Sinclair technology with 
AMSTRAD's expertise in integration and engineering reliability, and flair for producing a ‘no 
nonsense - all-in-one package. 


Software compatibility 

The +3 may be used with software written for the earlier models in the ZX Spectrum range This 
means that a vast quantity of software already exists for the +3 There are literally thousands of titles 
available covering every conceivable application, games, utilities, music, scientific, educational and 
many many more. 


The BASIC 


The +3 uses a computer language called BASIC (Beginners' All-purpose Symbolic Instruction 
Code). BASIC is by far the commonest language for home computers, and +3 BASIC has been 
designed to be particularly easy to learn and use. 


How to read this book 

In order to get the best out of your +3 it is vital that you read all the relevant information provided in 
this manual. If you skip various sections, it is likely that you will come to a grinding halt later on! 

Therefore, you should adopt the following reading programme.. 

Chapter 1 - This chapter shows you how to connect up your +3 system. Note especially the safety 
warnings regarding the wirmg-up of the mams plug. 

Chapter 2 - This chapter describes the switching on of the +3 and shows you how to tune-in your TV 
to display the computer s signal. You are then shown how to select an option from the opening menu 
-and if you don't know how to do that, you'll not be able to use the +3 at all! If. however, you do know 
how to tune-in your TV and select menu options (perhaps by having previously used a Spectrum 128 
or a +2). then you may skip this chapter 
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Chapter 3 - This chapter shows you how to load commercially available disk software. If you never 
intend to use such software, then you may skip this chapter. 

Chapter 4 • This chapter shows you how to load commercially available pre-recorded tape software. 
If you never intend to use such software, then you may skip this chapter. 

Chapter 5 - This chapter covers the use of the +3 s built-in disk drive (known as dnve A:). You may 
skip this chapter only if you never intend use the disk drive during BASIC programming (perhaps 
having purchased the +3 solely to load and run commercially available software (eg. games)). Note 
that if you have connected an additional disk dnve (B:) to the +3. then throughout this manual you 
should take any general references to the disk drive' as meaning both drives (A: and B:). 

Chapter 6 - This chapter introduces you to +3 BASIC. In particular, it describes the editor and 
certain aspects of BASIC programming that differ from those of other computers. Therefore, even if 
you are an experienced BASIC programmer on another computer, you should still read chapter 6. 
Note that you'll require a blank CF-2 floppy disk as you work through this chapter. If. however, you 
never intend to program in BASIC and have purchased the +3 solely to load and run commercially 
available software (eg. games), then you may skip this chapter. 

Chapter 7 - This is the one chapter that you may freely skip. It describes the 48 BASIC mode (in which 
the +3 operates exactly like the old-style’ Spectrum - even in the editing and programming 
aspects). This mode is not recommended for anything other than a history lesson for the curious, or for 
loading old (Spectrum 48 only) tape software. You should certainly not use this mode for BASIC 
programming; indeed you cannot access many of the advanced features of the +3 (including disk 
drive, extra memory, RS232/MIDI/AUX interfaces or RAMdisk) from 48 BASIC. Notwithstanding the 
above, we have provided the relevant information in this chapter for your reference. 

Chapter 8 - This chapter forms the very heart of the manual. It is a complete guide to BASIC 
programming on the +3. If you have programmed in BASIC before, then you may wish to use this 
chapter merely as a reference guide, searching the main index to find the information you need from 
one of the subsections. If, on the other hand, you are new to BASIC, you may wish to work through the 
chapter, one subsection at a time, developing your programming skills as you go. Once you are able 
to type in and run a program, and have grasped a few of the fundamentals of BASIC, then you may feel 
confident about skipping ahead to later subsections. If, however, you never intend to program in 
BASIC and have purchased the +3 solely to load and run commercially available software (eg. 
games), then you may skip this chapter. 

Chapter 9 - This chapter shows you how to use the +3 as a calculator only. You may skip this chapter 
if you wish. 

Chapter 10 - This chapter illustrates how add-ons (peripherals) are connected to the +3. Peripherals 
include such devices as a cassette unit, a printer, an additional disk drive, a joystick, etc. So if you’re 
thinking of linking up any device at all to the +3, check this chapter to make sure that you've got the 
right connections. If on the other hand, you intend to use just the standard +3 set up (ie. computer 
and TV only), then you may skip this chapter 
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Precautions! 


You must read this.... 

(Don't worry if you are a little baffled by some of the technical jargon m this section, the importance of 

these warnings will become clearer as you work through this manual.) 

1. Always connect the mains lead of the power supply unit (PSU) to a 3-pin plug following the 
instructions given in chapter 1. 

2. Do not attempt to connect the PSU to any mains supply other than 220-240V AC 50Hz. 

3. After you have finished using the +3 always disconnect the PSU from the mains supply socket 

4 There are no user serviceable parts inside the equipment - DO NOT ATTEMPT TO GAIN 
ACCESS INSIDE THE PSU ■ THERE ARE HIGH VOLTAGES INSIDE Refer all servicing to 
qualified service personnel. 

5. Do not block or cover the ventilation slots in the equipment. 

6 Do not use or store the equipment in excessively hot. cold. damp, or dusty areas 

7. Never plug in (or unplug) any device from any of the rear sockets while the +3 is switched on 
-doing so will probably damage both the +3 and the device 

8. Never switch the +3 on or off while a disk is inserted in the disk drive. Doing so may corrupt 
your disk, losing valuable programs or data. 

9. After you have switched off your TV (or VDU monitor), do not immediately disconnect the +3 
■ -wait a few seconds or so 

10. Do not switch off the +3 (or switch on or off any peripheral devices connected to the +3) while 
there is a program or data in the memory that you wish to keep - doing so may make the +3 
crash, losing the program or data 

11. Always keep the disk drive and disks away from magnetic fields For maximum data reliability, 
do not position the disk drive close to your TV or monitor, or close to any source of electrical 
interference 

12. If you have connected an additional disk drive to the +3. keep the ribbor. cable (to the additional 
drive) away from mains leads 

13 Whenever possible, make back-up (duplicate) copies of disks which contain valuable programs 
Otherwise should you accidentally icse or corrupt the disk, replacing it may prove very 

expensive 

14 Never touch the floppy disk surface itself, inside its protective casing 

15 Do not c-ject a disk while it is being read from or written to 

!6 Aiw tys remember that formatting a disk will erase its previous contents 
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Chapter 1 
Open the box 


















Fitting a mains plug 


The power supply unit for the Spectrum +3 operates from a 220-240 Volt AC 50Hz mains supply. 

Fit a proper mains plug to the mains lead of the power supply unit. If a 13Amp(BS1363)plugisused, a 
3 Amp fuse must be fitted. The 13 Amp fuse supplied in a new plug must NOT be used. If any other 
type of plug is used, a 5 Amp fuse must be fitted either in the plug or adaptor or at the distribution 
board. 

IMPORTANT - The wires in this mains lead are coloured in accordance with the following code... 

Blue : Neutral 
Brown : Live 

As the colours of the wires in the mains lead of this apparatus may not correspond with the coloured 
markings identifying the terminals in your plug, proceed as follows.,. 

The wire which is coloured BLUE must be connected to the terminal which is marked with the letter N 
or coloured black. 

The wire which is coloured BROWN must be connected to the terminal which is marked with the 
letter L or coloured red. 

Disconnect the mains plug from the supply socket when not in use. 

Do not attempt to remove any screws, nor open the casing of the power supply unit. Always obey the 
warning on the rating label of the power supply unit... 


WARNING: LIVE PARTS INSIDE - DO NOT REMOVE ANY SCREWS 


Settingup 

We will now set up the standard +3 system. All you need (other than the items you unpacked) is a 
standard TV set (UHF). You can use a colour or black-and-white TV, but of course, with the latter you 
will not be able to enjoy the full colour capabilities of your +3, 

Note that if you wish to attach one or more add-ons, or peripherals . (eg, printer, joystick, cassette 
deck, second disk drive, monitor, audio amplifier, MIDI device, modem or other serial/expansion 
device) to your +3 system, you should turn to chapter 10 (Peripherals for your +3). 

Place the +3 computer on a suitable flat surface, ready to be connected to your TV. Next, remove 
any plug which is already connected to the aerial socket at the back of the TV. Using the aerial lead 
provided with your +3, insert the larger plug into the TV’s aerial socket, and insert the smaller plug 
into the socket marked TV at the back of the + 3 

Finally, insert the 6-pin DIN plug coming from the power supply unit into the socket marked PSU at 
the back of the +3. 

The +3 system is now ready to be switched on. 
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Chapter 2 
Operating your +3 


Subjects covered... 


Switching on 
Tuning-in your TV 
Using the +3 
The opening menu 


Switching on 

Connect the mams plug of the power supply unit to the mains supply socket, and switch on the 
socket-switch (if necessary). The power indicator lamp on the top panel of the +3 should illuminate 

Now switch on your TV. On the screen you will probably see either a faint TV picture or just random 
“white noise’ and hear a loud hissing’ sound from the TV’s speaker. Adjust the TVs volume control until 
the sound is at a comfortable listening level. The next thing to do is set up the +3 ready for tuning-m. 


Preparing to tune-in your TV 

The +3 is capable of generating its own test signal, enabling you to tune-in the TV accurately. The 
test signal consists of sixteen vertical colour bars (overprinted with text characters) which appear on 
the TV screen, and a repeatmg tone which is reproduced through the TV’s speaker (If you are using a 
black-and-white TV, then the colour bars appear as varying shades of grey) You will see and hear the 
test signal when you have completed the tuning-in of your TV (described ahead). 
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Switch on the test signal by holding down the BREAK key (at the top right of the keyboard) and while 
it is held down, press and release the RESET button (at the left hand side of the +3). Keep the 
BREAK key held down for a few seconds longer, then release it. The test signal will now be 
generated by the +3, and you should proceed to tune-m your TV as now described. 


Push-button TV channel selectors 

If your TV doesn ’t have push-button channel selectors, then skip to the section ahead entitled 'Manual 
tuning'. 

If your TV does have push-button channel selectors, then press one of them to select a spare channel 
(le. one not normally used for receiving TV or video programmes). Note that if your TV is equipped 
with an AFC (or AFT) switch, then this should be set to the opposition. 

Using the tuning control that corresponds to the selected channel, tune-in to the test signal (shown on 
the previous page). Make sure that both picture and sound are tuned-in for the best possible results. 

When you are satisfied with the tuning, then you may (if your TV is so equipped) set the AFC (or AFT) 
switch to the on position. 

Finally, adjust the TVs brightness, contrast and colour controls for the clearest display of the text 
characters within the colour bars. 

Now that you have tuned-in one of the TVs push-button channel selectors specifically for the +3, you 
may thereafter select that particular channel whenever you wish to use the +3 with your TV. 

You may now skip to the section ahead entitlec} 'Using the +3 ’. 


Manual tuning 


If your TV isn’t equipped with push-button channel selectors, then you will have to use the TVs manual 
tuning knob to tune-in to your +3. 

Having connected and switched on the +3 and TV, switch on the +3 's test signal as described in 
the previous section entitled 'Preparing to tune-m your TV. 

Tune-m the TVs manual tuning knob until the test signal is received. Make sure that both picture and 
sound are tuned-in for the best possible results. 

Finally, adjust the TVs brightness, contrast and colour controls for the clearest display of the text 
characters within the colour bars. 

Each time that you wish to set up and use the +3 with your TV. you should follow the above manual 
tuning procedure. 

You may now skip to the section ahead entitled Using the +3 ’. 
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Having problems? 

If you have tuned-in your TV satisfactorily, you may now slap to the section ahead entitled Using the +3 

If, however, you are unable to tune-in your TV, the following check list may help you to ascertain where the 
problem lies, and what remedial action you can take. 

1. Problem... 

The power indicator lamp (on the top panel of the +3) is not illuminated. 

Action... 

* Check 6-pin DIN plug from power supply unit is plugged into PSU socket on computer. 

* Check mains plug of PSU is plugged into mains supply socket. 

* (Ifmainssupply socket is switched) - Check supply socket switch is on. 

* Check connections and fuse in mains plug of PSU. 

2. Problem... 

The power indicator lamp is illuminated, but no signal whatsoever can be tuned-in on the TV. 

Action... 

* Check TV is set up and working correctly. 

* Check TV is standard UHF type (colour or black-and-white). 

* Check aenal lead (supplied) is connected from computer to TV aenal socket. 

* (If you have push-button channel selectors) - Check you are tuning-in the channel you selected. 

3. Problem... 

Only a poor signal tom the computer can be tuned-in on the TV. 

Action... 

* Check TV is set up and working correctly. 

* Check aenal lead (supplied) is fully plugged into computer and TV aenal socket. 

* (If TV is so equipped) - Check AFC (or AFT) switch is set to off position. 

* Check tuning-m has been earned out as accurately as possible. 

4. Problem.. 

A signal tom the computer is being tuned-in, but it's not the test signal described above. 

Action... 

* Check computer's test signal has been switched on (as desenbed in the previous section entitled 
'Preparing to tune-m your TV'). 

5. Problem. 

The test signal colour bars appear, but no sound (repeating tone) is audible tom the TV’s speaker. 

Action... 

’ Check TVs volume control is not at minimum. 

* Check tuning-in has been earned out as accurately as possible. 
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6. Problem... 

The test signal sound (repeating tone) can be heard, but no colour bars can be seen on the TV. 

Action... 

* Check TV s brightness, contrast and colour controls are not at minimum. 

* Check tuning-in has been carried out as accurately as possible. 

7. Problem... 

The test signal colour bars and sound are tuned-in, but none of the text characters can be read. 

Action... 

* Check tumng-in has been earned out as accurately as possible. 

* Check TVs brightness, contrast and colour controls are adjusted for best results. 

If you cannot identify the cause of your problem, try carrying out the entire procedure (from the 
beginning of this chapter) again. If the problem still persists contact your Sinclair dealer, 

Using the +3 

The +3 system should now be fully set up, with the test signal colour bars on the screen, and the 
repeating tone coming from the TVs speaker 

We will now switch off the test signal and start using the +3 Press and release the RESET button (at 
the left hand side of the +3). The test signal will disappear from the screen, and in its place will be the 

opening menu. 

The opening menu 



Note that the opening menu initially indicates which drives are available for use: drive A: is the built-in 
disk drive (at the front of the computer) and drive M: is the +3 's mtemal RAMdisk (more about this in 
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chapter 8 part 20). If you have connected an external disk drive to the +3, then you will see drive B; 
also indicated on the menu. The opening menu will appear whenever you first plug in and switch on 
the +3, or whenever you press and release the RESET button. 

As its name suggests, the menu offers you a selection of options. You can choose from one of the four 
options which appear within the central box on the screen. These are... 


Loader 


-Choose this option if you wish to load Spectrum +3, Spectrum +2 or 
Spectrum 128 software. 


+ 3 BASIC 


-Choose this option if you wish to use the +3 for BASIC programming. 


Calculator - Choose this option if you wish to use the +3 as a calculator only. 

4 8 B A SIC - Choose this option if you wish to load Spectrum 48 software from tape (or 

wish to use the +3 as a 48K Spectrum). 


How to choose an option 

Notice that the menu option Loader appears to be highlighted by a 'bar'. This means that the 
Loader option is ready to be selected - (the selection hasn't been confirmed yet). For the purpose 
of this example, let's assume that you don't want to select Loader, but that instead, you want to 
select + 3 B A SIC This means that you need to move the highlight bar to the option + 3BASIC.To 
do this, use the cursor keys (shown below) until the highlight bar moves to the desired position. 



Cursor Keys 


When the highlight bar is on + 3 B A SIC , confirm this choice by pressing the ENTER key 
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The computer then switches to the +3 BASIC mode. You will see a black horizontal bar (containing 
the words + 3 B A S IC ) towards the bottom of the screen, and a flashing blue and white blob (called 
the cursor ) at the top left-hand comer. 

Don’t worry if you know nothing about BASIC - we’re not going to do any programming just yet - we'll 
simply return to the opening menu again. To do this, we use a different menu - this one’s called the edit 
menu. Call up the edit menu by pressing the EDIT key. 



Again, using the cursor keys and ENTER, select the option E x i t to return to the opening menu. 

You may now select whichever opening menu option you require. Depending upon your selection, 
refer to the following chapters for further information... 


Loader 
+ 3 BASIC 
Calculator 
48 BASIC 


- Refer to chapters 3 and 4. 

- Refer to chapters 6 and 8. 
-Refer to chapter 9. 

- Refer to chapters 4 and 7. 


IMPORTANT - Whenever you have finished using the + 3 , always disconnect the power 
supply unit from the mains supply socket (having first removed any disk from the disk drive). 
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Chapter 3 

How to load disk software 


Subjects covered... 

Disks for the +3 
Loading disk software 
Abandoning loading 

This chapter describes the loading of commercially available disk software. 

(For a description of the loading, saving, formatting, etc., procedures that you would use during BASIC 
programming, see chapter 6 and chapter 8 part 20.) 


Disks for the +3 

The +3 uses 5 inch :omj lisks We strongly recommend that for reliable data-to-disk 

transfer you use AV1SOFT CT-2 compact floppy disks Disks made by other leading manufacturers 
however, may also be used. 

Each side of a disk may be used independently. A disk should be inserted with its label facing 
outward from the drive, and with the side that you wish to use face up 
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Loading disk software 


To load Spectrum + 3 , Spectrum +2 and Spectrum 128 software (a game, an utility program, etc.) 
from disk, carry out the following instructions... 

1. Set up and switch on the + 3 so that the opening menu appears on the screen... 



2. Insert your software disk into the disk drive. 

3. Press the ENTER key to select the option L o a d e r from the opening menu. (If you don't know 
about selecting menu options, refer back to chapter 2.) 

The software will start to load from disk. On the disk drive, you will see the read/write indicator lamp 
start to flash on and off (indicating that the disk is being read from). After a few seconds, the screen 
display will change and the software will be loaded, ready to use. 

When you have finished using the software and wish to use the +3 for something else, press and 
release the RESET button (at the left-hand side of the + 3 ). Always remember that whenever the 
RESET button is pressed, everything in the computer’s memory (RAM) is cleared. You should 
therefore always make sure that you have completely finished with any program in the +3 's 
memory, before you press the button 

If you are going to switch off the +3 completely, remember to remove any disk from the disk 
drive first. 


Abandoning loading 

If you wish to abandon a loading operation, simply press and release the RESET button. The +3 will 
return to the opening menu. 


20 






Chapter 4 

How to load tape software 


Subjects covered... 


Using tape instead of disk 

Loading Spectrum + 3 , Spectrum +2 and Spectrum 128 software 
Loading Spectrum 48 software 
Abandoning loading 

This chapter describes the loading of commercially available pre-recorded tape software. 

(For a description of the loading, saving, formatting, etc., procedures that you would use during BASIC 
programming, see chapter 6 and chapter 8 part 20.) 

Using tape instead of disk 

So far, you have seen how to load software from disk. To use tape, first set up the +3 system so that 
your cassette unit is connected to the TAPE/SOUND socket at the back of the +3 (details of 
connections to this socket will be found in chapter 10). 

Spectrum 4-3, Spectrum +2 and Spectrum 128 software 

To load Spectrum +3 , Spectrum +2 or Spectrum 128 software (a game, an utility program, etc.) 
from tape, carry out the following instructions... 

1. Switch on the system so that the opening menu appears on the screen... 
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2. Make sure that no disk is inserted in the disk dnve 

3. Press the ENTER <ey to select the option Loader from the opening menu (If you don't know 
about selecting menu options, refer back to chapter 2) 

Now skip to the section ahead entitled ‘Loading from tape' 

Note that when you select the L o a d e r option from the opening menu, the +3 knows that you wish 
to load from tape (instead of disk) by automatically detecting the absence of a disk in the disk drive. If 
a disk is inserted, the tape will be ignored. 

Spectrum 48 software 

To load Spectrum 48 software (a game, an utility program, etc.) from tape, carry out the following 
instructions... 

1. Switch on the system so that the opening menu appears on the screen.. 






2. Select the option 48 BASIC from the opening menu. (If you don’t know how to select a menu 
option, refer back to chapter 2,) The opening menu will disappear and the following message will be 
displayed at the bottom of the screen.. 



3. Now press the J key once, followed by the " (double quotes) key twice, The screenshould look like this... 



When you see this message, press ENTER 

Now skip to the section ahead entitled 'Loading from tape 1 

(If the screen does not correspond to the above picture, then you may have selected the wrong menu 
option or pressed the wrong key In this case, press and release the RESET button (at the left-hand 
side of the +3) and carry out steps 2 and 3 again.) 
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Loading from tape 

1 laser: the software tape into your cassette unit and make sure that it is rewound to the oeginning 

2 Play the cassette. As loading commences, the border colour will flash and appear striped, 
indicating that the program is being read' from the tape. If your TV's volume control is turned up, you 
will also hear a varying high-pitched tone Again, this is an indication that the program is being read. 

Most commercially available software cassettes take a few minutes to load. Initially, the program 
name may appear (toward the top left-hand corner of the screen) possibly followed by various other 
displays or messages (these will differ from program to program). 

When the program has loaded, stop the cassette. The software is then ready to use 

When you have finished using the software and wish to use the +3 for something else, press and 
release the RESET button (at the left-hand side of the +3). Always remember that whenever the 
RESET button is pressed, everything m the computer's memory (RAM) is cleared. You should 
therefore always make sure that you have completely finished with any program m the +3 s 
memory before you press the button 


Abandoning loading 

If, while loading software from tape, you wish to abandon the loading operation, then simply press and 
release the RESET button. The +3 will return to the opening menu 

NOTE - Holding the BREAK key down while loading Spectrum + 3.'Spectrum -t-2 or Spectrum 128 
software will return the +3 to Ihe opening menu; holding the key down while loading Spectrum 48 
software will return the +3 to the 48 BASlCroode 
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Chapter 5 
The +3 disk drive 


Subjects covered... 

Disks and drives 
Insertion 
Write protection 
Read/write indicator lamp 
Eject button 

Disks and drives 

'i-*-3 : i nipact floppy A iranoiy minend thal Ion I 

li r. nstoi you us*. AMSOnCi-H ••mpac %.|.py Disks muby other • r: :i.. ,i: ■ 

If you have connected an additional disk dnve to the +3 note that the main disk drive (.within (he 
+3) is called drive A: and the second (additional) disk dnve is called drive B: 

Insertion 

Each side of a disk may be used separately, A disk should be inserted with its label facing outward 
from the drive, and with the side that you wish to use face up 
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Write protection 


In ihe left-hand comer of each side of a blank disk you will see an arrow pointing to a small shuttered 
hole This is called the write protect hole, and allows you to protect the contents of the disk from 
erasure or 'overwriting 1 ... 



When the hole is closed data can be 'written' onto the disk by the computer When the hole is open , 
however, the disk will not allow data to be written onto it, thus enabling you to avoid the accidental 
erasure of valuable programs 
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Various disk manufacturers employ differing mechanisms for opening and closing the write protect 
hole The operation may be carried out on the AMSOFT CF-2 compact floppy disk as follows 

To open the write protect hole, slide back the small shutter located at the left-hand corner of the disk, 
and the hole will be opened... 

Wnte protect hole (OPEN) 



Once the hole is open, write protection is ON 

To close the wnte protect hole, simply slide the shutter to its closed position Write protection is then OFF 
Other manufacturers' disks employ a small lever located in a slot at the left-hand comer 


Lever 


Write protect 
hole 

(CLOSED) 

Wnte protection OFF 
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To open the write protect hole on this type of disk, slide the lever towards the middle of the disk (using 
the tip of a ball-point pen or similar object), 


Slide levet 
towards middle 
of disk 



Noie that regardless of the method employed to open and close the write protect hole, opening the 
hole in all cases facilitates protection against overwntmg. 

When your disk is in 

At the front of the disk drive, you will see a push button (for ejecting the disk), and a red lamp (called 
the read/write indicator lamp ), 








Read/write indicator lamp 


This lamp indicates that data is being read from or written to the disk Note, however that if a second 
disk dnve is connected, the read/wnte indicator lamp on drive B. will be constantly on (except when 
drive A: is reading or writing to disk), 


Eject button 

Pressing m the eject button allows you to remove your disk from the disk dnve 
Do not press the eject button while the disk is being read from or wntten to. 
Always eject your disk from the disk dnve before switching the system off. 
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Chapter 6 

Introducing +3 BASIC 


Subjects covered... 

The editor 
The edit menu 

Renumbering a BASIC program 
Swapping screens 
Listing to the printer 
Typing in a program 
Moving the cursor 
Running a program 
Commands and instructions 
Simple disk operations 
Formatting a disk 
Saving a program 
Filenames 
Disk catalog 
Loading a program 
Error reports 

The +3 has an advanced editor to create, modify and run BASIC programs. To enter the editor, 
select the option + 3 B A SIC from the opening menu, using the cursor keys and ENTER. (If you don’t 
know how to select a menu option, refer back to chapter 2.J 

The screen should now look like this 



There are three things to notice about this screen. 
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Firstly, there is a flashing blue and white blob m the top left-hand corner. This is called the cursor, and 
if you type any letters at the keyboard, then they will appear on the screen at the position of the cursor 

Secondly, there s a black bar towards the bottom of the screen. This is called the footer bar, and tells 
you which part of the +3 s built-in software you're using At the moment, it says+ 3 BASIC because 
that's the name of the editor. 

The last item of note at the moment is the small screen, This fits between the footer bar and the bottom 
of the screen, and is currently blank. It only has room for two lines of text, and is most often used by the 
-f3 when it detects an error and needs to print a report to say so, It does have other uses, however, 
and these will be described latei 

Now press the EDIT key You will nonce Two things happen - the cursor vanishes, and a new menu 
appears. This is called the edit menu 



The edit menu's ophons are selected in the same way as for the openmg menu (by using the cursor 
keys and ENTER) 

Taking the options in turn . 

+ 3 B A S IC - This option simply cancels the edit menu and restores the cursor On the face of it- not 
very useful; however, if EDIT is pressed accidentally, then this option allows you to return to your 
program with no damage done 

Renumber - BASIC programs use line numbers to determine the order of the instructions to be 
carried out, You enter these numbers (which can be any whole-number from 1 to 9999) at the 
beginning of each program line you type m. Selecting the Renumber option causes the BASIC 
program's hne numbers to start at line 10 and go up in steps of 10 BASIC commands which include 
references to line numbers (such as G 0 TO, GO SUB, LINE RESTORE RUN and LIST) also 
have these references renumbered accordingly. 


32 






If for any reason it's not possible to renumber, perhaps because there's no program in the 9-3 or 
because Renumber would generate line numbers greater than 9899, then the +3 makes a 
low-pitched bleep and the menu goes away 

A useful aid to this renumbering facility can be found in chapter 8 part 33 

Screen - This option moves the cursor into the smaller (bottom) part of the screen, and allows 
BASIC to be entered and edited there. This is most useful for working with graphics, as any editing in 
the bottom screen does not disturb the top screen To switch back to the top screen (which you can do 
at any time whilst edihng), select the edit menu option Screen again. 

P r i n t - If a pnnter is connected, this option will print-out a listing of the current program to it. When 
the listing has finished, the menu will go away and the cursor will come back. If for some reason the 
computer cannot prrnt (eg. the pnnter is not connected or is off-line), then pressing the BREAK key 
twice will return you to the editor 

Exit- This option returns you to the opening menu - the +3 retains any program that you were 
working on m the memory If you wish to go back to the program again, select the option + 3 B A SIC 
from the opening menu. 

If you select the opening menu option 48 BASIC (or if you switch off or leset the 9-3), then any 
program m the memory will be lost (You may, however, use the opening menu option 
Calculator without losing a program in the memory) 

Reset the computer and select +3 BASIC. Now type in the line below As you type it m, the 
characters will appear on the screen (a character is a letter, number, space, etc.). Note that to type in 
the equals sign = you should hold down the SYMB SHIFT key, then press the L key once. Try typing 
in the line now, .. 


10 for f = 1 to 100 step 10 

then press ENTER Providing you have spelt everything correctly the 9-3 should have reprinted 
the line with the words FOR TO and S T E P tn capital letters, likethis.. 

10 FOR f=1 TO 100 STEP 10 


The 9-3 should have also emitted a short high-pitched bleep, and moved the cursor to the start of the 
next toe 

If the line remains m small letters and you hear a low-pitched bleep, then this indicates that you have 
typed in something 'wrong Note also that the colour of the cursor changes to red when a mistake is 
detected and you must correct the line before it will be accepted by the 9-3 To do this, use the 
cursor keys to move to the part of the line that you wish to correct, then type in any characters you wish 
to insert (or use the DELETE key to remove any characters you wish to gel rid of) When you have 
finally corrected the line, press ENTER 
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Now type in the line below.. 

(The colon : is obtained by SYMB SHIFT and 2. and the minus sign - is obtained by SYMB SHIFT 
and J.) 


20 plot 0,0:draw f,175:plot 255,0:draw -f,175 


then press ENTER, On the screen you will see.. 

10 FOR f=1 TO 100 STEP 10 
20 PLOT 0,0: DRAW f,175: PLOT 
255,0: DRAW -f,175 


Don't worry about line 20 'spilling over' onto the next line of the screen - the computer will take care of 
this and align the text so that it is easier to read. Unlike a typewriter, there's no need for you to do 
anything when you approach the end of a screen line because the +3 detects this automatically and 
moves the cursor to the beginning of a new line. 

The final line of this program to type in is. 

30 next f 
again, press ENTER 

The numbers at the beginning of each line are called line numbers and are used to identify each line. 
The line you just typed m is line 30, and the cursor should be positioned just below it, As an exercise, 
we will now edit fine 10 (to change the number 1 0 0 to 2 5 5). Press the cursor up <r> Key (four times) 
until the cursor has moved up to line 10, Now press the cursor nght i) key until the cursor has moved 
to the nght of 100. Press DELETE three times and you will see the 100 disappear. Now type in 
25 5 and press ENTER. Line 10 of the program hasnow been edited,. 

10 FOR f=1 TO 255 STEP 10 


The computer has opened up a new fine in preparation for some new text. Type 

run 

Press ENTER and watch what happens. Firstly, the footer bar and the program lines are cleared off 
the screen as the +3 BASIC editor prepares to hand over control to the program you've iust typed in 
Then the program starts, draws a pattern, and stops with the report. 

0 OK, 30:1 

Don’t worry about what this report means 
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Press ENTER. The screen will clear and the footer bar will come back, as will the program listing, 
This takes about a second or so, during which time the +3 won If be taking mput from the keyboard, 
so don't try and type anything while it's all happening. 

You've just done most of the major operations necessary to program and use a computer! First, you've 
given the +3 a list of instructions. Instructions tell the +3 what to do (like the instruction 
30 NEXT f). Instructions have a line number and are 'stored away rather than used immediately 
you type them in. Then you gave the +3 the command r u n to execute the stored program 

Commands are just like instructions, only they don I have line numbers and the +3 carries them out 
immediately (as soon as ENTER is pressed). In general, any instruction can be used as a command, 
and vice versa - it all depends on the circumstances Every instruction or command must have at least 
one keyword Keywords make up the vocabulary of the computer, and many of them require 
parameters In the command DRAW 40,200 for example, D R A W is the keyword, while 4 0 and 
200 are the parameters (telling the computer exactly where to do the drawing). Everything the 
computer does in BASIC will follow these rules. 

Now press EDIT and select the Screen option. The editor moves the program down into the 
bottom screen, and gets nd of the footer bar, You can only see line 10 of the program as the rest is 
hiding' off-screen (you can prove this by moving the cursor up and down) 

Press ENTER then type. 

run 


Press ENTER again, and the program will run exactly the same as before, But this time, if you press 
ENTER afterwards, the screen doesn t clear, and you can move up and down the program listing 
(using the cursor keys) without disturbing the top screen. If you press EDIT to get the edit menu you 
might think that this would mess up the top screen. However, the +3 remembers whatever s behind 
the edit menu and restores it when the menu is removed. 

To prove that the editor really is working m the bottom screen, press ENTER and change line 10to 

10 FOR f=1 TO 255 STEP 7 


,.by moving the cursor to the end of line 10 (just to the nght of S T E P 10), then pressing DELETE 
twice, and typing 7 (press ENTER ) 

Now type... 

go to 10 


(Press ENTER.) The keywords g o t o tell the +3 not to clear the screen before starting the 
program. The modified program draws a slightly different pattern on top of the old one. You may 
continue editing the program to add further patterns, if you wish. 
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A word of warning - while editing in the bottom screen, don't try to edit instructions which are more 
than two screen lines long Otherwise, when the editor comes across an instrucnon which has its 
beginning or its end off-screen, it may become 'confused' (The same is true of the top screen, but of 
course, this is unlikely to cause any problems as the screen is so much larger) 

One thing you may notice while you're typing away is that CAPS SHIFT and the number keys used 
together do strange things. CAPS SHIFT with 5, 6 , 7 and 8 move the cursor about, CAPS SHIFT with 
1 calls up the edit menu, CAPS SHIFT with 0 deletesa character, CAPS SHIFT with 2 is equivalent to 
CAPS LOCK, and finally CAPS SHIFT with 9 selects graphics mode All of these functions are 
available using the dedicated keys on the +3 and so there is no reason why you should ever want tc 
use the above CAPS SHIFT and number key alternatives. 

Simple disk operations 

You have now seen how to place a program into the computer's memory by typing it in, This is all very 
well the first time you write a particular program, but what about if you switch off the computer and 
want to use the same program the next day? Surely you don't have to type it all in again from scratch 
-the answer of course, is no - the disk drive section of the +3 allows you to save a program from the 
computet s memory onto a disk, and to load a program from a disk into the computer's memory This 
means that you can type in a program save it to disk, then happiiy switch off the +3 knowing that 
next tune you switch it on. you'll be able to load that same program back into the memory 

The final part of this chapter, therefore, deals with these two very important operations (saving and 
loading). However, before you can do either of these you will be shown how to prepare a brand new 
disk so that it is ready for saving programs onto This preparation process is called formatting 

You will need to have a brand new blank disk to hand as you work through this chapter Whatever 
you do - don’t use a disk with any valuable software, games, etc. on it 


Disks and tapes 

Even if you are familiar with tape saving and loading, it is worth pointuig out two important points 
which must be remembered when dealing with disks: 

Firstly, a brand new blank disk cannot be simply taken out of its wrapper and recorded onto (as is the 
case with a tape) instead, each side of a disk must be formatted first. Note that the formatting 
process completely erases that side of the disk. 

Secondly, it is important that disk files are correctly 'named' Filenames on tape may vary greatly in 
length and may at times be omitted, Not so with disks disk filenames must conform to very strict 
standards (and you will read aboutthese shortly in the section ahead entitled 'Filenames') 


Formatting a disk 

Formatting can be likened to building a series of shelves and pigeonholes on a disk prior to the 
storage of information on those shelves. In other words, formatting lays down an organised framework 
around which data can be put m or taken out. 
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The formatting process divides the disk into 360 distinctly separate areas.. 


Track 39 



There are 40 concentric tracks from the outside ol the disk (Track 0) to the inside (Track 39), and each 
track is divided into 9 sectors 

Each portion of track m a sector can store up- to S12 bytes of data; hence the total available space on 
each side of a disk is 180 kilobytes (180K). Note that 7K of the 180K is reserved for the computer's own 
use, this leaves 173Kper side for your programs. 

We will now format a new blank disk, and save the program below... 

10 FOR f=1 TO 255 STEP 7 
20 PLOT 0,0: DRAW f,175: PLOT 
255,0: DRAW -f,175 
30 NEXT f 

which should still be in the memory from the previous exercise (check that the above program is 
currently in the memory by pressing ENTER then typing.. 

List 

(Press ENTER again.) If the program isn't m the memory (or you have since switched off the -f 3), then 
switch it on, select + 3 B A SIC and type m the above program), 


37 



insert side 1 of a new blank disk into the disk drive and type,,. 

format "a:" 

(Press ENTER,) The read/write indicator lamp on the disk drive will start to flash on and off. About 30 
seconds later, you will see the report.. 

0 OK, 0:1 

You have now formatted side l of the disk. Once you have done this, you should not need to format side 
1 of that disk ever agam, 

(If you don’t receive the above report (and some other message appears instead) check the section 
entitled 'Error reports’ at the end of this chapter.) 


Saving a program 

Having formatted side 1, it is now ready for saving programs onto 

In order that each program file on a disk can be identified, you must give the program a filename 
when you save it. For example, as the program that you are about to save draws a patterned picture, 
save the program using the name pattern, pic', ie. type in . 

save "pattern.pic" 

(Press ENTER) After a few seconds, you will see the report 

0 OK, 0:1 

The program is now saved onto disk 

(If you don’t receive the above report (and some other message appears instead), check the section 
entitled 'Enoneports' at the end of this chapter.) 


Filenames 

Note that a filename on disk consists of two parts ( fields ) The first field is obligatory and can contain up 
to 8 characters (letters and numbers may be used but no spaces or punctuation marks), In the above 
example filename, pattern’ is the first field 

The second field is optional. You can use up to 3 characters (but again no spaces or punctuation). In 
the above example filename, pic' is the second field, 

If you use two fields in a filename, they must be separated by a dot (eg, pattempic'). 


38 




Disk catalog 

A catalog of the disk (in alphabetical order) can be displayed by typing in. 

cat 

(Press ENTER ) The filenames of all the programs on that side of the disk will be displayed, together 
with each file's length (to the nearest higher kilobyte} The amount of free space will also be 
indicated 

PATTERN .PIC IK 
172K free 

Loading a program 

Imagine that you have switched off the +3 and later want to load the program you have just saved. 
Do this now by resetting the +3 (using the RESET button) and selecting the option +3 BASIC 
from the opening menu. Type m. 

load "pattern.pic" 

(Press ENTER,) After a few seconds, you will see the report... 

0 OK, 0:1 

The program is now loaded from disk Press ENTER and you will see the program listing displayed 

(If you don't receive the above report (and some other message appears instead), check the next 
section entitled 'Error reports’.) 

Once loaded, youmay run the program by simply typing 

run 

and pressing ENTER, as before 

Error reports 

If you don't correctly carry out the instructions in this section, you may receive various error reports If 
so, identify the report (from those shown below), read the explanation given and then take the 
necessary corrective action. 

Drive not ready 

The above report means that you have probably forgotten to insert a disk into the disk dnve. If there is 
a disk inserted m the disk dnve, then eject it, re-insert it and try again 
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Disk is write protected 


The above report means that you are trying to format, or save a program to, a disk which has its write 
protect hole open. Eject the disk, close its write protect hole, re-insert the disk and try again 

File not found 

The above report means that you are trying to load a program which doesn't exist on that side of the 
disk Eject the disk, make sure that the correct disk is inserted (the right way up) and try again, Take 
care to ensure tbatyou accurately type in the filename to load 

Bad fiLename 


..or.. 


Inva Lid fiLename 

The above reports mean that you are trying to load or save a program using an illegal filename (or no 
filename at all). Read the section entitled 'Filenames' earlier in this chapter and try again 

Disk is aLready formatted 
A to abandon, other key continue 

The above report means that you are trying to format a disk that has already been formatted. In 
general, a disk should need formatting only once (at the beginning of us life). In rare cases, a disk may 
become corrupted and there will be no alternative other than to format it again. However, unless, this 
is the case, you should always type A (to abandon) when you see the above report 

NOTE - If you don't type A. then the formatting process will go ahead and completely erase that side oi 
the disk (as soon as you press a key), 

11 you find that one particular disk (or side ofa disk) keeps requiring formatting, then it is likeiy that the 
disk itself is damaged and you should avoid 'using it in future 

Some commands that fail will produce leports that offeT you the options.. 

- Retry, Ignore or CanceL? 

If you receive the above options, then 

typing R (after taking the necessary corrective action) makes the computer retry the command: 

..typing I makes the computer ignore ihe reason that the command failed in the first place and 
continue regardlessly (typing I is therefore not recommended unless you know exactly what you're 
doing), 

typing C abandons the command (this may be followed by the appearanceof another report; 
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Further information 


Further information on disk operations (together with details of how to use the +3 's RAMdisk and 
how to use an external cassette unit) can be found m chapter 8 part 20. A guide to +3DOS 
(the +3 Disk Operating System) will be found m chapter 8 part 27, 
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Chapter 7 
Using 48 BASIC 


Subjects covered... 


Using the + 3 as a 48K Spectrum 
Entering 48 BASIC mode 
The keyboard under 48 BASIC 
Program entry 
Editing the current line 

The +3 has the ability to act exactly like a 48K Spectrum (or Spectrum +), This is achieved by 
selecting the option 4 8 B A SIC from the opening menu. In 48 BASIC mode, many of the enhanced 
features of the +3 (such as the disk drive, extra memory, Ml screen editor, multi-channel sound, 
RS232/MIDI/AUX interfaces and RAMdisk) cannot be used The JOYSTICK 1 and JOYSTICK 2 
sockets will still operate, however. 

The 48 BASIC mode is included for compatibility reasons only - there is no advantage in using 48 
BASIC mode (instead of +3 BASIC mode) to write programs, and it is not recommended. The 
following mformanon is included for reference only, or for anybody who is used to the old 48K 
Spectrum and wants to use the machine immediately without having to learn about the +3 BASIC 
editor, 

There are, in fact, two methods of entering the 48 BASIC mode, the first is by selecting the 
48 BASIC opnon from the opening menu (if you don't know how to select a menu option, refer 
back to chapter 2), When 48 BASIC starts up, you will see the following on the screen, 



The second method allows you to enter the 48 BASIC mode while editing a +3 BASIC program. To 
do thus (while in +3 BASIC mode), type., 
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spectrum 

and press ENTER. The +3 will respond with an 0 K message and will have changed to 48 BASIC 
mode, retaining any program that you had in memory, Once in 48 BASIC mode, there is no way back 
to +3 BASIC mode apart from resetting the +3 (or switching off, then on again ) 

One major difference between 48 BASIC and + 3 BASIC is in the entering and editing of programs 
(Note also that in 48 BASIC the tokens SPECTRUM and PLAY have replaced the user defined 
graphics characters for the keys T and U under +3 BASIC(valuesl63andl64).) 

Once in 48 BASIC mode, the keyboard performs as follows 

All the BASIC commands, functions and operators are available directly from the keyboard rathei 
than needing to be spelled out. In order to accommodate all these functions and commands, some 
keys have five or more distinct meanings, obtained partly by shifting' the keys (le. pressing either 
CAPS SHIFT or SYMB SHIFT together with the required key); and partly by having the machine in 
different modes The flashing cursor contains a letter (K L. C. E or G) to indicate which mode you are 
operating in. 

K (for Keywords) mode automatically replaces L (for Letters) mode when the machine is expecting a 
commandor program line (rather than mput data), and from its position on the line the +3 knowsthat 
it should expect either a line number or a keyword K mode occurs at the beginning of a line, or after a 
colon : (except in a string), or after the keyword THEN Whenever the K cursor appears, the next 
key pressed will be interpreted as either a keyword or a line number, as follows... 



The keyboard in K mode 
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L (for Letters) mode normally occurs at all tunes (other than K mode, described above). Whenever 
the L cursor appears, the next key pressed will be interpreted as per the legends on the key-tops 
themselves, ie.. 



R! 

■ 

■ 

■ 







0 

BREAK 


CftAPH 

0 

w 

E 

R 

T 

Y 

U 

i 

0 

P 

■ 

EXTEKOWODE 

EDIT 

A 

■ 

■ 

■ 

6 

H 

J 

K 

■ 


CAPS SHIFT 

CAPS 

LOCK 

Z 

X 

C 

V 

B 

N 

M 



CAPS SHIFT 


■ 

■ 

■ 


SPACE 

■ 

■ 

■ 

SYMB 

SHIFT 


The keyboard in L mode 


In both K and L modes, pressing SYMB SHIFT together with a key will be interpreted as follows.. 



The keyboard using SYMB SHIFT in K or L mode 


Using CAPS SHIFT m L mode simply converts small letters to capitals. In K mode, however, CAPS 
SHIR" does not affect the keywords. 

C (for Capitals) mode is a variant of L mode whereby all letters appear as capitals, The CAPS LOCK 
key is used to change from L mode to C mode, and back again. 
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E (for Extended) mode is used to obtain further characters, mostly tokens. It is entered by pressing 
the EXTEND MODE key, and lasts for only one character (or key depression) thereafter. Whenever 
the E cursor appears, the next key pressed will be interpreted as follows.. 




The keyboard using CAPS SHIR in E mode 




























































































Applying SYMB SHIFT whilein E mode, the next key pressed will be interpreted as follows... 



The keyboard using SYMB SHIFT in E mode 


G (for Graphics) mode occurs when GRAPH is pressed, and lasts until it is pressed again (or 9 is pres¬ 
sed on its own). A number key will give a mosaic graphic, and each of the letter keys (apart from V W 
X, Y and Z) will give a user-defined graphic which, until it is defined, will look identical to a capital 
letter. Whenever the G cursor appears, the next key pressed will be interpreted as follows. 
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m 

SH! 
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Dll 
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II 
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The keyboard in G mode 


*3? 
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The keyboard using CAPS SHIFT in 6 mode 


General keyboard notes 

If any key is held down for more than 2 or 3 seconds it will start repeating Keyboard input appears in 
the bottom half of the screen as it is typed, each character (single symbol or compound token) being 
inserted just before the cursor The cursor can be moved left and right using the cursor control keys 
00 (to the left of the space bar) The character to the left of the cursor can be removed 'lsir.c 

DELETE 

When ENTER is pressed, the lme is either executed, entered into the program, or used as input data 
If the lme contains a syntax error , however, a flashing question mark ? appears next to the error. 

As program lines are entered, a listing is displayed m the top half of the screen The last line entered is 
called the current line and is indicated by the symbol > after the line number. Any line m the program 
may be selected as the current line (for editing purposes) by using the up and down cursor keys -o -o 
(to the nght of the space bar) To then edit the selected current line, press the EDIT key. (Editing 
takes place at the bottom of the screen.) 

When a command is executed or a program is run, output is displayed m the top half of the screen and 
remains there until either ENTER or the cursor up or down key oo is pressed. At the bottom of the 
screen appears a report giving a code (digit or letter) referred to in part 29 of chapter 8 This report 
remains on the screen until a key is pressed and the +3 returns to K mode 
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Chapter 8 

The +3 BASIC programmer’s guide 


Parti 

Introduction 

Whether you read chapter 6 first, or came straight here, you should beaware that. 

Commands are obeyed straight away. 

Instructions begin wi th a line number and are stored away for later use. 

This guide to BASIC starts by repeating some of the information given in chapter 6 (Introducing 
+3 BASIC), bui in greater detail. You may also find exercises at the end of some sections - don't 
ignore these, as many of them illustrate points that are hinted at in the text. Look through them, and do 
any that interest you or that seem to cover ground that you don't understand properly, 


The Keyboard 



Tne characters used on the +3 comprise not only single symbols (letters, digits, etc.) but also compound 
tokens (keywords, function names, etc,). Everything must be typed in full, and m most cases it doesn't matter 
whether capital letters (known as UPPER CASE) or small letters ( lowercase ) are used, "'here are three sorts 
of keys on the keyboard: letter and number keys (called alphanumenc keys), symbol keys (punctuation 
marks), and control keys (things like CAPS SHIFT, DELETE and so on). 
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The most commonly used keys for BASIC are the alphanumeric keys. When a letter key is pressed, a 
lower case letter will appear on the screen together with a flashing blue and white blob called the 
cursor To get an upper case letter, the CAPS SHIFT key should be held down while the letter is 
typed, 

Lf you wish to continuously type upper case letters, then pressing the CAPS LOCK key once will 
make all subsequent letters typed upper case To return to lower case letters, simply press 
CAPS LOCK again 

To type the symbols which appear on the alphanumeric keys on the keyboard, le, 

()_<> T - -*- = :£?/* 

simply hold down the SYMB SHIFT key while the alphanumeric key with the required symbol on it 
is pressed (see the following diagram),, 
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SHIFT 


SYMB 

ISHIFT 


Symbols available using SYMB SHIFT 


Additionally, the symbols. 

[ ] © " I \ { > 


can be obtained by fust pressing the EXTEND MODE key once, then holding down SYMB SHIFT 
while pressing the appropriate alphanumeric key (see the following diagram),,, 
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Symbols available using SYMB SHIFT in EXTEND MODE 


To enter graphics mode, the GRAPH key is pressed once. Mosaic graphics (see the following 
diagram) can then be produced by pressing the number keys (except 9 and 0 ). Pressing the letter 
keys (except T, U, V, W, X. Y and Z) produce user-defined graphics (if set up). 
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Mosaic graphics available using GRAPH 

To obtain inverted mosaic graphics, press the above number keys while holding down CAPS SHIR 
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General keyboard notes 

If any key is held down for raoi e than 2 or 3 seconds, it will start repeating As keys are pressed, a line 
will be built up on the screen. A line, by the way, means a line of BASIC, and may easily be several 
lines long on the screen Thecursorkeys 00 can be used to move about the line, and if the part of 

the line that the cursor is moved to is off screen, then the text on screen will scroll up or down to display 
it Any characters typed will be inserted at the cursor, and pressing DELETE causes the character to 
the left of the cursor to be removed. As soon as ENTER is pressed or any attempt is made to move the 
cursor off the line, the +3 checks to see if the line makes sense Ifitdoes.ihenthereisahigh-pitched 
bleep, and the line is either acted upon immediately or stored away as part of a program If the line 
contains an error, then the +3 generates a low-pitched bleep and moves the cursor to the area 
where it thinks the error is (the colour of the cursor also changes to red to indicate the enor). It is 
impossible to move off a line which contams an enor - the +3 will always move the cursor back, 


The monitor screen 

This has 24 lines (each being 32 characters long) and is divided into two parts The larger (top) part of 
the screen is at most 22 lines and displays either a listing or program output It is the one used most 
often for editing. When printing in the top part has reached its bottom limit, the contents scroll up by 
one line If, however, scrolling would mean losing a line that you haven’t yet had a chance to see. then 
the +3 stops with the message.. 

scroll? 

Pressmgany key (except N, BREAK or the space bar) will let scrolling continue, 

Pressing one of the keys N. BREAK or the space bar will make the program stop with the repot ! 

D BREAK - CONT repeats 

The smaller (bottom) part of the screen is used for editing short programs, entering input data, 
entermg direct commands (where the main screen must not be used, eg graphics programs), and 
also for displaying reports 


Program entry 

If the program being entered gets bigger than the screen size, then the -f 3 attempts to display the 
aiea of most interest (usually the last lme entered together with its surrounding lines). You may. 
however, specify a different area of the program to be displayed using the command 

LI ST xxx 
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where xxx' is a line number, telling the +3 to bring a specified area of the program into view. 

When a command is executed or a program is run, output is displayed in the top part of the screen and 
remains there when the program brushes (until a key is pressed). If the program is being edued m the 
bottom part of the screen, then any output in the top screen will stay there until it is either overwritten, 
scrolled off, or a C L S command is issued The bottom screen may display a report giving a code 
(digit or letter) referred to in part 29 of this chapter This report remains in the bottom screen until a 
key is pressed. 

While the +3 is running a BASIC program, the BREAK key is checked every so often. This happens 
at the end of a statement, during use of the cassette unit (if connected) or printer (if connected), or 
while music is being played If the +3 finds that the BREAK key is pressed, then program execution 
stops and displays a report, The program may then be edited. 
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Part 2 

Simple programming concepts 

Subjects covered... 


Programs 
Line numbers 

Editing programs using OOoo 
RUN, LIST 

GO TO, CONTINUE, INPUT,NEW,REM 
PRINT 

Stopping a program 


Type in the following first two lines of a program (which will eventually print the sum of two numbers) 
Don't forget to press ENTER after you type each hne. 

20 print a 
10 let a=10 

Note that the screen looks like this.. 

10 LET a = 1 0 

I 

20 PRINT a 


As we have already discussed - because these lines began with numbers, they were not obeyed 
immediately but were stored away as program lines. You will have also noticed here that the line 
numbers govern the order in which the program lines are to be executed, and as you can see on the 
screen the +3 sorts all the lines into order whenever a new line is entered. 

Note also that although we typed each line in lower case letters, the keywords (le. P RIN T and LET) 
were converted to upper case as soon the line was entered and accepted by the +3 From now on, 
we will show keywords to be typed in upper case letters: however, you may continue to type m lower 
case letters. 

(By the way, If you don't know what a keyword is, you should have studied chapter 6 before reading 
this chapter.) 

So far you have only entered one number, so type 

15 LET b= 1 5 
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and press ENTER. Now you need to change lme 20 to,,, 


20 PRINT a+b 

You could type out the replacement line in full, but it is far easier to move the cursor (using the cursor 
keys) to just after the a, and then type . 

+ b (don't prass ENTER veil 

Check that the line then reads. 


20 PRINT a+b 

then press ENTER, The cursor will move to the line below, and the screen should look like this 

10 LET a = 1 0 
15 LET b= 1 5 
20 PRINT a+b 

I 


What you have done in this program is to have assigned the value 10 to the variable called a, and the 
value 15 to the variable called b You have then instructed the computer to pnnt the sum of these two 
values by simply adding the two variables. 

Run this program by typing.., 

RUN 

and pressing ENTER The sum of the two numbers will be displayed, 

25 

Run the program again and then afterwards, press ENTER and type 
PRINT a,b 


Now press ENTER again and notice how the values of the variables a and b are still m the +3 s 
memory, even though the program has finished.. 

10 15 
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Mistakes 

If you enter a line by mistake, say., 

12 LET b=8 

.and you wish to delete the line, then simply type.,. 

12 

. and press ENTER . Line 12 will vanish, and the cursor will reappear where line 12 used to be 
Now type 

30 

and press ENTER. The +3 will search for line 30. and since there isn’t one, it will fall off the end ol 
the program The cursor will be positioned just after the last line. If you enter any non-existent line 
number (such as 30), then the +3 will place the cursor where it thinks the line would have been if it 
really existed. This can be a useful way of moving about large programs, but beware - it can also be 
very dangerous because if the line really did exist before you entered the line number - it certainly 
wouldn't exist afterwards! 

To list a program on the screen, type. 

LIST 

and press ENTER You may (particularly when working with more lengthy programs) wish to list 
from a certain point onwards This can be achieved by typing an appropriate line number after the 
LIST command, 

Type.. 


LIST 15 

and press ENTER to see this illustrated 

When we were developing the above program, note how we were able to insert line 15 between the 
other two lines - this would have been impossible if they had been numbered l and 2 instead of 10 and 
20 It is always good practice, therefore, to leave gaps between line numbers 

(Note that line numbers must be entered as whole numbers between 1 and 9999.) 

If at some time, you find that you haven't left enough space between line numbers then you may use 
the edit menu to renumber a program To do this, press the EDIT key then select the Renumber 
option from the menu that appears, this sets the gap between each line number to 10 Try this out and 
see how thehnenumberschange 
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We are now going to use the BASIC command NEW This erases any existing programs and vanabies 
m the +3 s memory- The command should be used whenever you are about to start afresh, so type.. 

NEW 

and press ENTER From now on. we won t mention press ENTER’ every time - we'll assume that 
you’ll remember. 

With the opening menu on the screen, start up BASIC by selecting theoption + 3 BAS IC 

Now carefully type in this program, which converts Fahrenheit temperatures to Celsius 
(centigrade) 


10 

REM t 

empe ra 

20 

PRINT 

"deg 

30 

PRINT 


40 

INPUT 

"Ente 

50 

PRINT 

f. 

60 

PRINT 

(f — 3 2 

70 

GO TO 

40 


ture conversion 
F'V'deg C" 

r deg F",f 

)*5/9 


Although you can type in all of line 10 in lower case, only the R E M will be converted to upper case on 
entry as its the only keyword that the +3 recognises. Also, although the words GO TO will appear 
with a space between them, they may be typed in as one word ( G 0 T 0) if you prefer 

Now run the program. The instructions will start being earned out in the order determined by the line 
numbers Fust of all, you’ll see the headings d e g F and d e g C printed on the screen (as instructed 
by Line 20), but what has line 10 done? It looks like the +3 has completely ignored it in fact, it has' 
The R E M m line 10 stands for remark, so line 10 is solely to remind you of what the program does, A 
REM command consists of R E M followed by anything you like - the +3 will ignore everything after 
the REM right up to the end of the line 

After line 20, the +3 carries out bne 30 which simply prints a blank line. When the +3 gets to the 
INPUT command in line 40 it waits for you to type m a value for the variable f - you can tell this 
because at the bottom of 'he screen is a flashing cursoi 

Type m a number (then press ENTER), The +3 displays the result and then waits for you to enter 
another number This is because the instruction in line 70 says GO TO 4 0 - m other words, 'instead 
of running out of program and stopping, jump back to line 40 and continue running from there 

So, enter another temperature, then another. 

After a tew more of these you might be wondering if the computer will ever get bored with this • it 
wont' Next time it asks for another number, hold down SYMB SHIFT and type A The woro STOP 
will appear and when you press ENTER the +3 comes back with the report 

H STOP in INPUT in Line 40:1 

which tells you why it stopped, and where (m line 40) (The : 1 after the line number in the report 
tells you that the 1 st instruction in line 40 is being reported upon.) 
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If you wish to continue the program, type 


CONTINUE 

and the +3 will ask you for another number. 

When CONTINUE is used, the +3 remembers the line number in the last report that it sent you (as 
long as the report was not 0 OK) and jumps back to that line, which m this case is line 40 (the 
INPUT command) 

Stop the program agam and replace line 70 by 

70 GO TO 31 

There wiil be no perceptible difference to the running of the program because tf the line number m a 
GO TO command refers to a non-existent line, then the ]ump is to the next line after the given 
number, The same goes for R U N (in fact, R U N on its own actually means RUN 0 ) 

Keep entenng numbers until the screen starts getting full When it is full, the +3 will move the whole 
of the top half of the screen up one line to make room, losmg the heading off the top - this is called 
scrolling 

When you are tired of entering numbers, stop the program as before and enter the editor by pressing 

ENTER 

Look at the P RIN T statement in line SO. The , comma in this Ime is very important. 

Commas are used to make the printing start either at the left-hand margin, or in the middle of the 
screen (depending upon which comes next). Thus m line SO, the comma causes the Celsius 
temperature to be printed in the middle of the line 

A semicolon ; on the other hand, is used to make the next number (or characters) be printed 
immediately after the preceding one(s). 

Another punctuation mark you can use like this m PRINT commands is the ' apostrophe. This 
makes whatever is printed next appear at the beginning of the next line on the screen. This also 
happens by default at the end of each PRINT command 

If you wish to inhibit this (so that whatever follows to be printed continues on the same line) you can put 
a comma or semicolon at the end of the P RIN T statement To see how this works, replace line 50 in 
turn by each of these. 

50 PRINT f, 

50 PRINT f; 

50 PRINT f 

and run the program each time to see the difference, 

The lme with the comma (you typed in originally) prints everything in two columns; the line with the 
semicolon crams everything together, and the lme without either, prints each number on a new line 
(you could have also used PRINT f 1 to do this) 
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Always remember the difference between commas and semicolons in P RIN T commands, and do 
not confuse them with : colons which are used as separators between commands on a single line, for 
example... 


PRINT f: GO TO 40 

Now type in these extra lines. 


100 

REM g 

reeting 

prog 

110 

INPUT 

"Enter 

your 

120 

PRINT 

"Hello 

";n$ 

130 

GO TO 

110 



This is a separate program from the last one, but you may keep them both in the -h3 at the same time, 
To run the new one, type 

RUN 100 

Because this program expects you to input a string (a character or group :f characters) instead ol a 
number, it prints out wo string quotes " " as a reminder So type in a name and press ENTER 

Next time round, you will get two string quotes again, but you don't have to use them if you don't want 
to Try this, for example rub out the quotes by pressing cursor right i) then DELETE twice, and 
type., 

n$ 

Since there are no stnna quotes, the +3 knows that it has to do some calculation - the calculation in 
this case is to find the value of the string variable called n $ (which is whatever name you happen to 
have typed m last time round). In this way. the 1NPUT statement acts like LET n$ = n$.sothe 
value of n $ is unchanged. 

If you wish to stop the program, delete the quotes then hold down SYMB SHIFT and type A 
then ENTER 

Now look back at that RUN 100 instruction which jumps to line 100 and runs the program from 
there You may be asking, What’s the difference between RUN 100 and G0 TO 100 y Well, 
RUN 100 first of all clears all the variables and the screen, and after that works just like 
GO TO 100 On the other hand. GO TO 100 doesn't clear anything, and there may well be 
occasions where you wish to run a program without cleanng any variables; here GO TO would be 
necessary and R U N could be disastrous, so it is better not to get into the habit of automatically typing 
RUN to start a program 

Another difference of course is that you may type RUN without a line number, and it starts off at the 
first line in the program; GO TO must always be followed by a line number. 
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Both this progiam and the 'temperature conversion' program stopped because you pressed 
SYMB SHIFT and typed A in the input line, Sometimes, you may write a program that you can't stop 
and that won't stc p itself. Type... 


200 GO TO 200 
RUN 200 


Although the screen is blank, the program is running - executing hne 200 over and over again This 
looks all set to go on forever unless you pull the plug out or reset the computer 1 However, there is a less 
drastic remedy - press the BREAK key The program will stop with the report 

L BREAK into program 

At the end of every statement, the program looks to see if this key is pressed, and if it is, then the 
program stops The BREAK uey can also be used when you are in the middle of using a printer • 
cassette unit, or various other add-ons that you can attach to the +3 

In these cases there is a different report.. 

D BREAK - CONT repeats 

The instruction C 0 N TIN U E in this case (and in most other cases too) repeats the statement whei : 
the prograr was stopped and cames straight on v/ith the next statement (after allowing for any lumps 
to be made 

Run the 'name' program again and when it ask? you for input, type. 

(after removing the quotes) 

Because n $ is an undefined variable, you will get the error report.. 

2 Variable not found 

If you now type 

LET n$="Fremsley" 

(which produces the report 0 OK, 0:1) and then type. 

CONTINUE 

you will find that you can use n $ as input data without any trouble 
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In this case CONTINUE does a jump to the IN P U T command m line 110. It disregards the report 
from the L E T statement because that said 0 K and jumps to the command referred to in the previous 
report, le. line 110 This feature can be extremely useful as it allows you to fix a program that has 
stopped due to errors, and thenCONTINUE from that point 

As we said before, the report L BREAK into program is special because after it. 
C 0 N TIN U E does not repeat the command where the program stopped 

You have now seer, the statements. PRINT LET INPUT RUN LIST GO TO 
CONTINUE NEWandREM and they can all be used either as direct commands or in program 
lines - this is true of almost all commands in +3 BASIC however RUN LIST CONTINUE and 
NEW are not usually of much use in aprogram 

Exercises 

1 Put a LIS T statement in a program so that when you run it. it lists itself afterwards 

2 Write a program to input prices and print out the tax due (at 15 percent). Put in P RIN T statements 
so that the +3 announces what it is going to do, and asks for the input price with extravagant 
politeness. Modify Iheprogram so that you can also input the tax rate (to allow for zero ratings or future 
changes). 

3 Wr ite a program to print a running total of numbers you input (like an adding machine) 

4 What would C 0 N TIN U E and N E W do in a program? Can you think of any uses at all for this’ 
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Part 3 
Decisions 

Subjects covered... 
CLS, IF, STOP 


Ail the programs we have seen so far have been pretty predictable - they went straight through the 
instructions, and then went back to the beginning again. This is not very useful, as in practice, we 
would want the +3 to make decisions and act accordingly. The instruction to do this in BASIC takes 
the form 

IF something is true (or not true) T H E N do something 

Let's look at an example of this Use NEW to clear the previous program from the +3, select 
+ 3 B A SIC then type in and run this program. (This is clearly meant for two people to play!). 

10 REM Guess the number 
20 INPUT "Enter a secret numbe 
r" ,a: CLS 

30 INPUT "Guess the number",b 

40 IF b=a THEN PRINT "That is 

correct": STOP 

50 IF b<a THEN PRINT "That is 

too small, try again" 

60 IF b>a THEN PRINT "That is 

too big, try again" 

70 GO TO 30 

Note that the C L S command (at the end of line 20) means clear the screen' We have used it in this 
program to stop the other person seeing the secret number after it is entered 

You can see that the IF statement takes the form. 

IF condition T H E N xxx 

. where 'xxx' stands for a command (or a sequence of commands separated by colons) The condition 
is something that is going to be worked out as either true or false - if it comes out as true then the 
statements in the rest of the line (after T H E N) are executed, otherwise they are skipped over, and the 
program executes the next instruction 
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The simplest conditions compare two numbers or two strings; they can test whether two numbers are 
equal or whether one is bigger than the other. They can also test whether two strings are equal, or 
whether one comes before the otherin alphanumerical order. They use the symbols =, <, >, <=, > - 
and < > (these are known as relational operators). 

= means is equal to, 

< means is less than 

> means is greater than. 

<= means is less than or equal to. 

> = means is greater than or equa 1 to, 

<> means is not equal to. 

(If you keep getting mixed up about the meanings of < and >, it may help you to remember that the 
thm end of the symbol points to the number which is supposed to be smaller) 

In the program we have just typed in, bne 40 compares a and b If they are equal, then the program is 
halted by the S T 0 P command. The report at the bottom of the screen. 

9 STOP statement, 40:3 

shows that the 3rd statement fie. the S T 0 P command) m line 40 caused the program to halt 

Line SO determines whether b is less than a , and line 60 whether b is greater than a , If one of these 
conditions is true then the appropriate comment is printed, and the program works its way down to 
line 70 which lumps back to line 30 and starts all over agam. 

Finally, note that in some versions of BASIC (not +3 BASIC) the IF statement can have the form 

I F condition T H E N line number 
This means the same as. 

IF condition THEN GO T 0 line number 

in +3 BASIC, 

Exercise,., 

1. Try this program.. 


10 

LET 

a = 1 



20 

LET 

b = 1 



30 

IF 

a>b THEN 

PRINT a;" 

is higher" 

40 

IF 

a<b THEN 

PRINT b;" 

is higher" 


Before you run it, try to work out what will be pnnted on the screen. 





Part 4 
Looping 


Subjects covered... 

FOR, NEXT 
TO, STEP 


Suppose you wish to input five numbers and add them together 
One way (don't type this in unless you are feeling dutiful) is as follows.. 

10 LET tota 1 = 0 
20 INPUT a 

30 LET tota l = tota l + a 
40 INPUT a 

50 LET total = tota l + a 
60 INPUT a 

70 LET tota l = tota l + a 
80 INPUT a 

90 LET tota l = tota l + a 
100 INPUT a 
110 LET tota l = tota l + a 
120 PRINT total 

This method is not good programming practice. It may be just about controllable for five numbers, but 
you can imagine how tedious a program like this to add twenty numbers would be, and to add □ 
hundred or more would be out of the question, 

Much better is to set up a variable to count up to 5 and then stop the program, like this (which you 
should type in). 

10 LET tot a 1 = 0 
20 LET count=1 
30 INPUT a 

40 REM count is number of time 
s that a has been input so 
far 

50 LET total=total+a 
60 LET count = count +1 
70 IF count <= 5 THEN GO TO 30 
80 PRINT total 

Notice how easy it would be to change fine 70 so that this program adds ten numbers, or even a hundred 
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This sort of thing is so useful that there are two special commands to make it easier - the FOR 
command and the N E X T command. They are always used together. Using these, the program you 
have just typed m does exactly the same as 


10 

LET tota 

1 = 0 


20 

FOR c=1 

TO 5 


30 

INPUT a 



40 

REM c is 

number of 

times th 


at a has 

been input 

so far 

50 

LET tota 

l = tota l + a 


60 

NEXT c 



80 

PRINT to 

ta l 



(To get this program from the previous one, you just have to edit lines 20, 40 and 60, then delete line 
70.) 

Note that we have changed c o u n t to c This is because the control variable ofaFOR NEXT loop 
must have a single letter as its name. 

The effect of this program is that c runs through the values 1 (the initial value), 2.3, 4 and S (the limit), 
and each time, lines 30, 40 and SO are executed. Then, when c has finished its five values, line 80 is 
executed. 

At this point, attempt exercise 2 (which refers to the above program), at the end of thus section. 

An extra subtlety to the F 0 R N E X T structure is that the control variable does not have to go up by 1 
each time - you can change this 1 to anything you like by using a S T E P part in the F 0 R command. 
The most general form of a F 0 R command is 

F 0 R control variable = initial value T 0 limit S T E P step 

, where the control variable is a single letter, and where the initial value, the limit and the step are all 
things that the +3 can calculate as numbers • like the actual numbers themselves, or sums, or the 
names of numeric variables. So, li you replace line 20 in the program by. 

20 FOR c — 1 TO 5 STEP 3/2 

this will step the control variable by the amount 3/2 each time the FOR loop is executed. Note that 
we could have simply said STEP 1. 5. or we could have assigned the step value to a variable, say 
s, and then said STEP s 

With the above modification, c will run through the values 1, 2.5 and 4 Notice that you don't have to 
restrict yourself to whole numbers, and also that the control value does not have to hit the limit exactly; 
it carries on looping as long as it is less than or equal to the limit 

At this point, attempt exercise 3 at the end of this section (which refers to the above program). 
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Step values can be negative instead of positive, Try this program which prmts out the numbers from I 
to 10 in reverse 01 jer (Remember, use the command NEW before typing in a new program). 

10 FOR n=10 TO 1 STEP -1 
20 PRINT n 
30 NEXT n 

We said before that the program carnes on looping as long as the control vanable is less than ot equal 
to the limit. If you consider what that would mean in this case, you'll see that it now doesn't hold true 
Hence, the mle has to be modified to say that when the step is negative, the program carries on 
looping as long as the control vanable is greater than or equal to the limit 

At this point, attempt exercises 4 and 5 at the end of this section (which refer to the above program) 

You must be careful if you are running two F 0 R N E X T loops together, one inside the other. Try this 
program, which pnnts out the numbers for a complete set of six dot dominoes 

10 FOR m=0 TO 6 
20 FOR n=0 TO m 
30 PRINT m;" 

40 NEXT n 
50 PRINT 
60 NEXT til 


} 


n loop 


\- m loop 


You can see that the n loop is entirely inside the m loop This means that they are properly nested 

However, what must be avoided is having two F 0 R NEXT loops that overlap without either being 
entirely inside the other, like this. 


5 

10 

20 

30 

40 

50 

60 


REM this program is 

FOR m=0 TO 6 

FOR n=0 TO m 

PRINT 

NEXT m 

PRINT 

NEXT n 


wrong 

m loop 


n loop 


Two FOR NEXTloopsmusteitherbeonemsidetheother or completely separate 

Another thing to avoid isiumping into the middle ofaFOR NEXT loop from the outside. The control 
variable is only set up properly when its F 0 R statement is executed, and if you miss this out, then the 
NEXT statement will confuse the +3 You will probably get an error report saying 

NEXT without FOR or Variable not found 
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There is nothing to stop you using aFOR NEXT loop m a direct command Forexample. try.. 

FOR m = 0 TO 10: PRINT m: NEXT m 

You can sometimes use this as a (somewhat artificial) way of getting around the restriction that you 
cannot GO TO anywhere inside a command - because a command has no line number For 
instance,. 

FOR m=0 TO 1 STEP 0: INPUT a: PRINT a: NEXT m 

The step size of zero here makes the command repeat itself forever. 

This sort of thmg is not really recommended, because if an error crops up then you have lost the 
command and will have to type it in again: moreover, CONTINUEwillnot work 

Exercises 

1 Make sure that you understand that a control variable not only has a name and a value (like an 
ordinary variable), but also a limit, a step, and a reference to the statement after the corresponding 
FOR statement. Ensure that when the FOR statement is executed all this information is available 
(using the initial value as the first value the variable takes), and also that this information is enough for 
the NEXT statement to know by how much to mciease the value, whether to lump back, and if so 
where to jump back to, 

2, Run the third program m this section, then type. 

PRINT c 

Why is the answer 6, and not S? 

(Answer The N E X T command in line 60 is executed five times, each time 1 being added to c. On the 
last time, c becomes 6 so the N E X T command decides not to loop back but to carry on. c now being 
past its limit) 

3. What happens if you put S T E P 2 at the end of line 20 of the third program? Try S T E P 10 

Now change the third program so that instead of automatically adding five numbers, it asks you to 
input the amount ofnumbers you wish to add. When you run thisprogram, what happens if you input 0 
(meaning that you don t wish to add any numbers) 9 Why might you expect this to cause problems for 
the +3 even though it is clear what youmean? 

4 In line 10 of the fourth program in this section change 10 to 10 0 and run the program It will print 
the numbers from 100 down to 79 on the screen, and then say s c r o tl ? at the bottom. This is to give 
you a chance to see the numbers that are about to be scrolled off the top If you prest N BREAK or the 
space bar, the program will stop with the report 0 BREAK - CONT repeats If you press 
any other key, then it will print another 22 lines and ask you again if you wish to scroll. 
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S. Delete line 30 from the fourth program. When you run the new curtailed program, it will pnnt the 
first number and stop with the message 0 0 K If you then type. 

NEXT n 


..the program will go once round the loop, printing out the next number 
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Part5 

Subroutines 

Subjects covered... 

GO SUB,RETURN 

Sometimes, different parts of the program will have rather similar jobs to do, and you will find yourself 
typing m the same lines two or more times: however, this is not necessary. Instead, you need only type 
in the lines once (in what's called a subroutine) and then call the subroutine into action whenever you 
need it in the program 

To do this, you use the statements GO S U B (go to subroutine) and R E T U R N This takes the form 

GO SUBxxx 

where 'xxx' is the line number of the first line m the subroutine It is just like G 0 TO xxx except that 
the +3 remembers where the GO SUB statement was. so that it can come back again after 
carrying out the subroutine 

(In case you ate interested, the +3 does this by remembering at which point in the program the 
GO SUB command was issued (in other words where it should continue from afterwards) and 
storing this return address on top of a pile called the G 0 SUB stack '• 

When the command.. 

RETURN 

is met (at the end of the subroutine used) me v-3 taxes the top return address off the G 0 SUB 
stack, and continues from the nextstatement. 

As an example, let s look at the numbei guessing program again, Retype it as follows 

10 REM "A rearranged guessing 
game" 

20 INPUT "Enter a secret numbe 
r" / a: CLS 

30 INPUT "Guess the number",b 
40 IF b=a THEN PRINT "Correct" 

: STOP 

50 IF b<a THEN GO SUB 100 
60 IF b>a THEN GO SUB 100 
70 GO TO 30 
100 PRINT "Try again" 

110 RETURN 
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The GO TO 30 statement m line 70 (and the S T 0 P statement m line 60 of the next program) are 
very important because otherwise the programs will run on into their subroutines and cause an error 
(7 RETURN without GO S UB) when the RE TURN statementis reached 

The following program uses a subroutine (from line 100 to 150) which prints a times table 
corresponding to the value of parameter n . The command GO SUB 100 may be issued from any 
point m the program to call the subroutine When the RETURN command m line 150 of the 
subroutine is reached, control returns to the main program which continues running from the 
statement after the G 0 SUBcaELikeGO TOGO SUBmaybetypedinasGOSUB 


10 

REM 

times 

ta 

bl.es 

for 2 , 


10 a 

nd 11 




20 

LET 

n = 2: 

GO 

SUB 

100 

30 

LET 

n = 5: 

GO 

SUB 

100 

40 

LET 

n = 1 0 : 

GO 

SUB 

100 

50 

LET 

n = 11 : 

GO 

SUB 

100 

60 

STOP 





70 

REM 

end o 

f m 

a i n 

program 


art 

of su 
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u t i n 

e 

100 

PRIN 

T n;" 

ti 

mes 

table" 

110 

FOR 

t=1 TO 9 



120 

PRIN 

T t;" 

X 

" • n • 
/ 11 / 

H - M . a. 
~ / L 

130 

NEXT 

t 




140 

PRINT 




150 

RETU 

RN 





One subroutine can happily call another, or even itself (a subroutine that calls itself is known as 

recursive) 
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Part 6 

Data in programs 

Subjects covered.. 

READ, DATA, RESTORE 


In some of the previous programs we saw that information, or data, can be entered directly into 
the -f 3 using the INPUT statement. Sometimes this can be very tedious, especially if a lot of the 
data is repeated every time the program is run. You can save a lot of time by using the READ, DATA 
and RESTORE commands. For example. 

10 READ a,b,c 
20 PRINT a,b,c 
30 DATA 1,2,3 

A R E A D statement consists of READ followed by a list of the names of variables, separated by 
commas. It works rather like an IN PUT statement, except that instead of getting you to type in the 
values to give to the variables, the +3 looks up the values in the D A T A statement. 

Each DATA statement is a list of expressions ■ numeric or string expressions - separated by commas. 
You can put them anywhere you like m a program, because the +3 ignores them except when it is 
doing a R E A D. You must imagine the expressions from ail the 0 A T A statements in the program as 
being put together to form one long list of expressions - the D A T A list The first time the +3 .goes to 
R E A D a value, it reads the first expression from the D A T A list; the next time, it reads the second, and 
thus as it meets successive READ statements, it works its way through the D A T A list. (If it tries to 
read past the end of the D A T A list, then it reports an error.) 

Note that it s a waste of time putting DATA statements in a direct command, because READ will not 
find them. DATA statements must go in a program. 

Let s see how ail this works in the program you've just typed in Line 10 tells the +3 to read three 
pieces of data and assign them to the variables a, b and c Line 20 then says PRINT these 
variables The DATA statement m line 30 provides the values of a, b and c lot line lOto read. 

The information in D A T A can be part ofa FOR NEXT loop Type in 


10 

DATA 2,4,6, 

,8,10,12 

20 

FOR n=1 TO 

6 

30 

READ d 


40 

PRINT d 


50 

NEXT n 



Note from the above two programs that a D A T A statement can appear anywhere - before or after the 
READ statement. 
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When the above program is ran, the R E A 0 statement moves through the 0 A T A list with each pass of 

the FOR NEXT loop 

DATA statements may also contain string variables. For example., 

10 FOR a=1 TO 7 
20 READ n$ 

30 PRINT n$ 

40 DATA "Bob'V'Edi th","Caro l e" 

,"Jacquie","Gavin","Charles 
"/'Holly" 

50 NEXT a 

The +3 doesn't have to READ the DATA statements in order • it can be made to 'jump about 
between DATA statements by using the RESTORE command. The form of the command is, 

RESTORExxx 

where to' is the line number of the D A T A statement to be R E A D from, If you use the command 
R E S T 0 R E on its own (without a line number) the +3 will jump to the first DATA statement in the 
program, 

Type m and run the following program... 


10 

DATA 1, 

2,3,4,5 

20 

DATA 6, 

7,8,9 

30 

GO SUB 

110 

40 

GO SUB 

110 

50 

GO SUB 

110 

60 

RESTORE 

20 

70 

GO SUB 

110 

80 

RESTORE 


90 

GO SUB 

110 

100 

STOP 


110 

READ a. 

b, c 

120 

PRINT a 

' b' c 

130 

PRINT 


140 

RETURN 



The command GO SUB 110 calls a subroutine which R E A Ds the next three items of D A T A and 
then P RIN T s them. Notice how the R E S T 0 R E command affects which items are read. 


Delete line 60 and run this program again to see what happens. 
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Part 7 

Expressions 

Subjects covered- 
Operations: 

Expressions, scientific notation, variable names 


You have already seen some of the ways in which the +3 can calculate with numbers. It can perform 
the four arithmetic operations +, - * and / (remember that * is used for multiplication, and / is 
used for division), and it can find the value of a variable, given its name. 

The example 

LET tax=sum*15/100 

..illustrates that calculations can be combined Such a combination, like sum* 15 /100, is called 
an expression - so an expression is lust a short-hand way of telling the +3 to do several calculanons, 
one after the other. In our example, the expression sum*15/100 means look up the value of the 
variable called sum, multiply it by IS, and divide by 100'. 

In expressions containing * / +, - multiplication and division are earned out first - they have a 
higher pnority than addition and subtraction Multiplication and division have the same pnonty as 
each other, which means that they are earned out in whichever order they appear in the expression 
(from left to right). The next operations to be earned out are addition and subtraction - these again 
have the same priority as each other and so. again, are carried out in order from left to right 

Hence m the expression 8-12/4+2*2 the first operation to be cameci out is the division 12/4 
which equals 3, so we can then represent the expression as8-3 + 2*2 

The next operation to be earned out is the multiplication 2*2 which equals4. so the expression ihen 
becomes 8 -3 + 4 

Next to be carried out is the subtraction 8-3 which equals 5, so the expression becomes 5 + 4 
Finally, the addition is carried out leaving the result 9. 

Try this out for yourself. Type m. 

PRINT 8-12/4+2*2 

A full list of the pnonties of mathematical (and logical) operations will be found in part 31 of this 
chapter. 
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You may, however, change the priority of calculations within an expression by the use of brackets. 
Calculations with; - brackets are earned out first, so if in, the above expression, you required the 
addmon 4 + 2 to be carried out first, you would enclose it in brackets. To see this, type in,.. 

PRINT 8-12/(4+2)*2 

and the result this time is 4 instead of 9, 

Expressions are useful because, whenever the +3 is expecting a number from you, you can give it 
an expression instead and it will work out the answer. 

You can also add together stnngs (or string variables) in a single expression. For example.. 

10 LET a$="large " 

20 LET b$="and puffy" 

30 LET c$=a$+b$ 

40 PRINT c$ 

We really ought to tell you what you can and cannot use as the names of variables. As we have already 
said, the name of a string variable has to be a single letter followed by $. and the name of the control 
variable in a FOR NEXT loop must be a single letter, however, the names of ordinary numeric 
variables are less restricted - they can use any letters or digits as long as the first one is a letter You 
can put spaces in as well to make it easier to read, but they won't count as part of the name. Also, it 
doesn't make any difference to the name whether you type it in upper or lower case letters There are 
some restrictions about variable names which are the same as commands however. In general, if the 
variable contains a BASIC keyword in it (with spaces around it) then it won t be accepted. 

Here are some examples of the names of vanables that are allowed. 

x 

any old thing 
142 

this name is impractical because it is too long 
tobeornottobe 
mixed cases spaces 
MixEdCAsEsSpAcES 

(Note that these last two names (mi xed cases spaces and Mi XEdCAsEsSpAcES) are 
considered the same, and refer to the same variable) 
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The following are not allowed as the names of variables., 


Pi 

any new thing 
421 
2001 

to be or not to be 

3 bears 
M*A*S*H 
Lloyd-Webbe r 


(PI isakeyword) 

(contains the separated keyword NEW) 
(begins withadigit) 

(contains digits only) 

(contains T 0 0 R and NOT, which are all 
separated keywords) 

(begins with a digit) 

(* is not a letter ora digit) 

(- is not a letter ot a digit) 


Numerical expressions can be represented by a number and exponent. Try the following to prove the 
point.. 


PRINT 2.34e0 
PRINT 2.34e 1 
PRINT 2.34e2 

...and so on up to 

PRINT 2.34e15 

PRINT gives only eight significant digits of a number. Try 

PRINT 4294967295, 4294967295-429e7 

This proves that the computer can hold the digits of 4294967295, even though it is not prepared to 
display them all at once. 

The +3 uses floating point arithmetic, which means that it keeps separate the digits of a number (its 
mantissa) and the position of the point (the exponent). This is not always exact, even for whole 
numbers. Type... 

PRINT 1e10+1-1e10,1e10-1e10+1 

Numbers are held to about nine and a half digits accuracy, so lelO is too big to be held exactly right, 
The inaccuracy (actually about 2) is more than 1, so the numbers lelO and lelO+i appear to the 
computer to be equal. 

For anevenmore peculiar example, type 

PRINT 5e9+1-5e9 

Here the inaccuracy in 5e9 is only about 1. and the 1 to be added on in fact gets rounded up to 2 The 
numbers 5e9+1 and 5e9+2 appear to the computer to be equal The largest integer (whole number) 
that can be held completely accurately is 4.294,967,294 


75 






* 


riic string " " with nr. haractei at ill is caned the empty or null stnng Remerr ber that spaces an 
significant and an empty stnng is not the same as one containing nothing but spaces. 

Try 


PRINT "Did you read "The Times" yesterday?" 

When you press ENTER you wi.. ret the flashing tedcursut that shows then: is a mistake somewher- 
tn the line When the +3 finds the double quotes at the beginiing -‘"The Times" it jm 
that these mark the end of the string "Did you read " and it then cant work out what 

The Times means 

There is a special device to get over this - whenever you wish tr write a string quote symbol ir. fhe- 
middleofastnnrj you must write it twice, like this, 

PRINT "Did you read ""The Times"" yesterday?" 

As you can see ! rom what is printed on the screen, each double quote is only really there once you 
mst have to type it twice to get it recognised 
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Part 8 
Strings 

Subjects covered- 

slicing, using T 0 


Given a string substring : 11* consists • fsonic c csecutiv* 'haiuet-'i ■ :r< m it. taken in sequence 
Thus "cut" is • substring of "cutlery" but "cute" s:.u "cruelty" are not 
substrings 

There is a nutaln n culled slicing r\ descubi::; ’Ubstrinus »nd »h& car.ce applied to arbitrary stnri' i 
expressions The general term is 

string expression (start T 0 finish 
.sc that, for instance 

"abedef"(2 TO 5) 


is equal t . bede 


If you omit the stan thc-r:. is assumed, ii y u -'it.ii the finish then the length of the string is assumed 
Thus 


"abcdef"( TO 5) isequaito abode 

"abedef "(2 TO ) isequalto bedef 

"abedef"( TO ) is^quati- abedef 

You m:.,-.: write this • • is"abcdef"() 

A'.iqhtlydiffertn- 1 : •mnnssesouitli* T0nnu usthast erruii.t r 

"abedef"(3) lsequal> "abedef "(3 TO 3) is-qvt,.’ c 

Although normaiiy bc-tti Start .-r,u finish must refer to existing parts of the string this rule is 'v&i ridden 
byariothen ik if the start is mi re than the finish then the result is the empty string So 

"abedef"(5 TO 7) 

the error 3 Subscript wrong: 

too many, but 

"abedef"(8 TO 7) 
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...and.. 


"abcdef"(1 TO 0) 


are both equal to the empty string "" and are therefore permitted, 

The start and finish must not be negative, or you get the error B integer out of 
range. This next program is a simple one illustrating some of these rules.. 

10 LET a$="abcdef" 

20 FOR n=1 TO 6 
30 PRINT a$(n TO 6) 

40 NEXT n 


Type NEW when this program has been run and enter the next program, 

10 LET a$="1234567890" 

20 FOR n=1 TO 10 

30 PRINT a$(n TO 1 0) ,a$((11-n) 

TO 10) 

40 NEXT n 


For string variables, wecan not only extract substrings, bul also assion to them. For instance, type 

LET a$ = "Ve Lvet Donkey" 


..and then.. 


LET a$(8 TO 13)="Lips******" 


and 


PRINT a$ 

Smce the substring a$(8 TO 13) is only 6 characters long, only its first 6 characters 
( L i p s * *) are used; the remaining 4 characters (****) are discarded. This is a characteristic of 
assigning to substrings, the substring has to be exactly the same length afterwards as it was before. To 
make sure this happens, the string that is being assigned to it is cut off on the right if it is loo long, or 
filled out with spaces if it is too short - this is called ‘Procrustean assignment' after the inn-keeper 
Procrustes who used to make sure that his guests fitted their beds by either stretching them out on a 
rack or cutting their feet off 
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Complicated stnng expressions will need brackets around them before they can be sliced. For 
example... 


"abc" + "def"(1 TO 2) isequalto "abcde" 

("abc" + "def ") (1 TO 2) isequalto "ab" 


Exercise.. 

1. Try writing a program to pnnt the day of the week using stnng slicing. (Hint - Let the string be 

SunMonTuesUednesThursFriSatur), 


-*■ 
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Part 9 
Functions 

Subjects covered... 

LEN,STR$, VAL, SGN, ABS, INT.SQR 
DEF FN 

Consider the sausage machine. You put a lump of meat in at one end turn a handle and out comes a 
sausage at the other end. A lump of pork gives a poik sausage slump of fish givesafish sausage, anda 
lump of beef a beef sausage. 

Functions are practically indistinguishable from sausage machines but there is a difference; they 
work on numbers and strings instead of meat You supply one value (called the argument), mince tt up 
by doing some calculations on it and eventually get another value - the result 

Meat in -» Sausage Machine -* Sausage out 

Argument m -* Function —► Result out 

Different arguments give different results, and if the argument is completely inappropriate the 
function will stop and give an error report 

Just as you can have diffeient machines to make different products - one for sausages, another for 
combs, a third for dish cloths, and so on. different functions will do different calculations. Each will 
have its own value to distinguish it from the others 

You use a function m expressions by typing its name followed by the argument, and when the 
expression is evaluated the result of the function will be worked out. 

As an example, there is a function called LEN which works out the length of a string. Its argument is 
the string whose length you wish to find, and its result is the length, so that if you type. 

PRINT LEN "Jammy Smears" 

the +3 will write the answer 12, le the number of characters (including spaces) ir. the string 

Jammy Smears 

If you mix functions and operations in a single expression, then the functions will be worked out before 
the operations. Again, however, you can circumvent this rule by using brackets. For instance, here 
are two expressions which differ only in the brackets, and yet calculations are performed m an 
entirely different order in each case (although, as it happens, the end results are the same 

LEN "Fred" + LEN "Bloggs" 

4 + LEN "Bloggs" 

4 + 6 

10 
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and.. 


LEN ("Fred" + "Bloggs") 
LEN ("FredBLoggs") 

LEN "FredBloggs" 

10 


Here are some more functions.. 

STRS converts numbers mto strings; its argument is a number, and its result is the string that would 
appear on the screen if the number were displayed by a P RIN T statement. Note how its name ends 
ma S sign to show that its result is a string. For example, you could say... 

LET a$= STRS 1e2 

which would have exactly the same effect as typing. 

LET a$="100" 

Or you could say 

PRINT LEN STRS 100.0000 

and get the answer 3, because STRS 100.0000 is equal to 100, the length of which is 3 
characters. 

V A L is like S T R $ m reverse - it converts strings into numbers For instance.. 

VAL "3.5" 

is equal to the number 3.5 

V A L is the reverse of S T R $ because if you take any number, apply STRS to it, and then appiy 

V A L 'o it, you get back to the number you first thought of. 

However, if you take a string, apply V A L to it. and then apply S T R $ to it you do not always get back 
to your original string 

V A L is an extremely powerful function, because the string which is its argument is not restricted to 
looking like a plain number - it can be any numeric expression. Thus, for instance. 

VAL "2*3" 
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is equal to 6. Even 

VAL ("2"+"*3") 

is equal to 6. There are two processes at work here. In the first, the argument of V A L is evaluated as 
a string • the string expression "2"+”*3" devaluated to give the string "2*3", Then, the string 
has its double quotes stripped off, and what is left is evaluated as a number: so 2 * 3 is evaluated to 
give the number 6 

There is another function, rather similar to VAL, though probably less useful, called VAL$. Its 
argument is still a string, but its result is also a stnng To see how this works, recall how VAL goes in 
two steps first its argument is evaluated as a string then the string quotes stnpped off this, and 
whatever is left is evaluated as a number, With V A LS, the first step is the same, but after the string 
quotes have been stripped off in the second step, whatever is left is evaluated as another string. 
Thus... 


VAL$ . Ursula""" is equal to Ursula 

(Notice how the stnng quotes proliferate again. ] Try, 

LET a$="99" 

...and print all of the following VAL a$ VAL "a$", VAL .a$., VAL$ a$ 

V A L$ "a $" and V A L$ """a$""". Some of these will work, and some of them won't - try to 
explain all the answers, 

SGN is the sign function (sometimes called signum). It is the first function you have seen that has 
nothing to do with strings, because both its argument and its result are numbers, The result is +1 if the 
argument is positive, 0 if the argument is zero, and -1 if the argument is negative 

A B S is another function whose argument and result are both numbers It converts the argument into a 
positive number (which is the result) by forgetting the sign, so that for instance 

ABS -3.2 

, is equal to 

ABS 3.2 

which is simply equal to 3,2, 

IN T stands for integer part - an integer is a whole number, possibly neganve This function converts 
a fractional number into an integer by throwing away' the fractional part, so that for instance., 

INT 3.9 

is equal to 3. 
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Be careful when you are applying if to negative numbers, because it always rounds down. Thus for 
instance 

INT -3.1 

.isequal to 4 

S Q R calculates the square root ol a number, le. the result that, when multiplied by itself, gives the 
argument, for instance 

SQR 4 

, is equal to 2 because 2 x 2 is equal to 4 

SQR 0.25 

, is equal to 0 5 because 0. S x 0.5 is equal to 0.25, 

SQR 2 

is equal to 1 4142136(appiox)because I 4I42I36X 1 4142136 lsequal to 2 (almcst) 

If you multiply any number (even a negative one) by itself, the answer is always positive. This means 
that negative numbers do not have square roots, so if you apply S Q R to a negative argument you get 
the error report A Invalid Argument 

You can also define functions of your own. Possible names for these are F N followed by a letter (if the 
result is a number) or F N followed by a letter followed by S (if the result is a string). These functions 
are much stricter about brackets - the argument must be enclosed in brackets. 

You define a function by putting a D E F statement somewhere m the program Tor instance, here is 
the definition of a function F N s whose result isthesquareof the argument.., 

10 DEF FN s(x)=x*x: REM the sq 
uare of x 

The s following the D E F F N is the name of the function. The x in brackets is a name by which you 
wish to refer to the argument of the function You can use any single letter you like for this (or, if the 
argument is a string, a single letter followed by $) 

After the - sign comes the actual definition of the function. This can be any expression, and it can also 
refer to the argument using the name you've given it (in this case, x) as though it were an ordinary 
variable. 
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When you have entered this line, you can invoke the function just like one of the +3 s own functions, 
by typing its nam.-. FN s followed by the argument Remember that when you have defined a 
function yourself, the argument must be enclosed in brackets. Try it out a few times.. 

PRINT FN s(2) 

PRINT FN s(3+4) 

PRINT 1+ INT FN s ( LEN "chi cken’72 + 3) 

Once you have put the corresponding D E F statement into the program, you can use your own 
functions m expressions just as freely as you can use the computer's, 

INT always rounds down. To round to the nearest integer, add 0.5 first - you could write your own 
function to do this.. 

20 DEF FN r(x)= INT (x+0.5): R 

EM gives x rounded to the n 
earest integer. 

You will then get, for instance... 

FN r(2.9) isequalto3 

FN r(2.4) isequalto2 

FN r(-2.9) isequalto-3 

FN r < - 2.4) is equal to -2 

Compare these with the answers you will get when you use IN T instead of F N r Type in and run 
the following, 

10 LET x=0: LET y=0: LET a=10 
20 DEF FN p(x,y)=a+x*y 
30 DEF FN q()=a+x*y 

40 PRINT FN p(2,3) , FN q() 

There are a lot of subtle points in this program. Firstly, a function is not restricted to just one argument; 
it can have more, or even none at all ■ but you must still always keep the brackets. 

Secondly, it doesn't matter whereabouts in the program you put the DEF statements After 
the +3 has executed line 10 it simply skips over lines 20 and 30 to get to line 40. They do, however 
have to be somewhere in the program • theycan'rbe inacommand 

Thirdly, x and y are both the names of variables in the program as a whole, and the names of 
arguments for the function F N p FN ptemporanlyforgetsaboutthevanablescalledxandy.but 
since it has no argument called a, it still remembers the variable a, Thus when FN p (2,3 ) is 
being evaluated, a has the value 10 because it is the variable, x has the value 2 because it is the first 
argument, and y has the value 3 because it is the second argument The resuit is then 10 + 2*3 
which is equal to 16, When F N q () is being evaluated on the other hand, there are no arguments, 
so a, x and y all still refer to the variables and so have the values 10,0 and 0 respectively The answer 
in this case is 1 0 + 0*0 whichis equal to 10 
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Now change line 20 to 

20 DEF FN p(x / y)= FN q() 

This time, FN p (2,3) will have the value 10 because F N q will still go back to the variables x 
and y rather than using the arguments of F N p 

Some BASICS (not +3 BASIC) have functions called LEFTS RIGHTS MIDSandTLS 
LEFT$(a$,n) gives the substring of a $ consisting of the first n characters 
RIGHT$(a$,n) gives the substring of a $ consisting of the characters from n th on, 
MID$(a$,n1 , n2 ) gives the substring of a $ consisting of n 2 characters, starting at the n 1 th 
T L$ (a £) gives the substring of a $ consishng of all its characters except the first. 

You can write some user-defined functions to do the same., 


10 

DEF 

FN 

t $(a$)=a$ ( 2 TO ): RE 


M TL$ 


20 

DEF 

FN 

l$(a$,n)=a$( TO n): 


REM 

LEF 

T$ 


Check that these work with strings of length 0 or i Note that our F N l $ has two arguments, one a 
number and the other a string A function can have up to 26 numeric arguments (why 26?) and at the 
same time up to 26 string arguments, 

Exercise 

Use the funcnon FN s ( x ) - x * x to test SQR You should find that,, 

FN s( SQR x) 

equals x if you substitute any positive number for x, ana 

SQR FN s(x) 

equals A B S x whether x is positive or negative (Why is the A B S there' 5 ). 
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Part 10 

Mathematical functions 

Subjects covered... 

t 

PI.EXP, LN.SIN, COS.TAN. ASN, ACS.ATN 

This section deals with the mathematics that the +3 can handle. Quite possibly you will never have 
to use any of this at all, so if you find it too heavy going, don't be afraid of skipping it It covers the 
operation j (raising to a power), the functions EX P and LN and the tngonometncal functions S I N 
C 0 S, T A N and their inverses A S N, A C S, and A T N 


and EXP 


You can raise one number to the power of another. This means ‘multiply the first number by itself the 
second number of times. This is normally shown by writing the second number just above and to the 
right of the first number; but obviously this would be difficult on a computer so we use the symbol | 
instead For example, the powers of 2 are. 

2 | lequals2 

2 t 2 equals 2x2 equals 4 (2 squared, normally written 2 Z ) 

2 } 3 equals 2x2x2 equals 8 (2 cubed, normally written 2’) 

2 t 4 equals 2 x 2 x 2 x 2 equals 16 (2 to the power of four, normally written 2*) 

. .and so on. 

Thus, at its most elementary level, a f b means 'a multiplied by itself b times', but obviously this only 
makes sense if b is a positive whole number To find a definition that works for other values of b, we 
consider the rule 

a f (b+c) equals a f bxa j c 

(Notice that we give f a higher priority than multiplication and division so that when there are several 
operations in one expression, f is evaluated before * and /). You should not need much convincing 
that this works when b and c are both positive whole numbers, but if we decide that we want it to work 
even when they are not, then we find ourselves compelled to accept that. 

a jOequalsl 
a j (-b) equals 1/a f b 

a f (1/b) equais the bth root of a. which is to say. the number that you have to multiply by itself b times to get a 

..and.. 

a t (bxc)equals(a f b) f c 



If you have never seen any of this before then don't try to remember it straight away, just remember 
that... 

a| (-1) equals 1/a 

...and.., 

a J (1/2) equals SQR a 

. . . and maybe when you are familiar with these, the rest will begin to make sense. 

Experiment with all this by trying this program.. 

10 INPUT a,b,c 

20 PRINT a*(b + c) ,a | b*a 1 c 

30 GO TO 10 

Of course, if the rule we gave earlier is true, then each time round, the two numbers that 
the +3 prints out will be equai. (Note-because ofthe way the computer worksout ‘, the number on 
the left, a in this case, must never be negative.) 

A rather typical example of what this function can be used for is that of compound interest. Suppose 
you keep some of your money in a building society and they give 15% interest per year. Then after one 
year you will have not just the 100% that you had anyway, but also the 15% interest that the building 
society has given you, making altogether 115% of what you had originally. To put it another way, you 
have multiplied your sum of money by 1.15, and this is true however much you had there in the first 
place, AfteT another year, the same wfll have happened again, so that you will then have 1.15 x 1.15, oi 
in other words, 1 15 f 2, or in other words, 1.3225 times your original sum of money In general then, 
after y years, you will have 1,15 \ y times what you started out with. 

If you try this command. 

FOR y = 0 TO 100: PRINT y,10*1.15|y: NEXT y 

.. .you will see that even starting off from just £ 10, it all mounts up quite quickly, and what's more, it gets 
faster and faster as tune goes on (though you might still find that it doesn't keep up with inflation). 

This sort of behaviour, where alter a fixed interval of tune some quantity multiplies itself by a fixed 
proportion, is called exponential growth, and it is calculated by raising a fixed number to the po weT of 
the hme. 

Supjrose you did this. 

10 DEF FN a(x) = a f x 

Here, a is more or less fixed, by L E T statements - its value will correspond to the interest rate, which 
changes only every so often, 
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There is a certain value for a that makes the function F N a look especially pretty to the trained eye 
of a mathematician; and this value is called e The +3 has a function called EXP defined by. 


EXP xisequaltoe f x 

Unfortunately, e itself is not an especially pretty r.umper, it is an infinite non-recurnno decimal You 
can see its first few decimal places by typing... 

PRINT EXP 1 

because EXP 1 is equal to e f 1 which is equal to e Of course this is just an approximation. You 
can never write down e exactly. 


LN 

The inverse of an exponential function is a logarithmic function - the logarithm (to base a) of a number 
x is the power to which you'd have to raise a to get the number x, and this is written logjX Thus by 
definition, a f log a x is equal to x. and it is also true that log (a f x) is equal to x. 

You may well already know how to use base 10 logarithms for doing multiplications, these are called 
common logarithms. The -f 3 has a function L N -which calculates logarithms to the base e these are 
called natural logarithms. To calculate logarithms to any other base, you must divide the natural 
logarithm by the natural logarithm of the base :e. io; a x is equal to LN x/LN a 


PI 


Given any circle, you can find its perimeter (the distance round Us edge ■ often called its 
circumference ) by multiplying its diameter ('width; by a number called it ~ (pronounced pi < is the 
Greek equivalent of the English letter p and it is used because it stands for pertmetei 

Like e 77 is an infinite non-recurring decimal - it starts off as 3.1415927. The word PI on the +3 is 
laken as standing for this number Try 

PRINT PI 
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SIN COS and TAN, ASN ACS and ATN 

These trigonometrical functions measure what happens when 3 point moves round a circle Here is a 
circle of radius 1 ('1 what’’ you may ask - it doesn't matter, as long as we keep to the same unit all the 
way through) and a point moving round it The point started at the 3 o’clock position, and then moved 
round in an anti-clockwise direction 
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We have also drawn in two lines called axes through the centre of the circle, The one through 3 o'clock 
is called the x-axis, and the one through 12 o'clock is called the y-axis 

To specify where the point is, you say how far it has moved round the circle from its 3 o'clock starting 
position let us call this distance a. We know that the circumference of the circle is 2ir (because Us 
radius is 1 and its diameter is thus 2); so when it has moved a quarter of the way round the circle, a is 
equal to ir/2; when it has moved halfway round, a is equal to ir, and when it has moved the whole way 
round, a is equal to 2n 

Given the curved distance round the edge • a, two other distances you might like to know are how far 
the point is to the nght of the y axis, and how far it is above the x-axis. These are called, respectively, 
the cosine and sine of a The functions COS and SIN on the +3 will calculate these 
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Note that if the point goes to the left o( the y-axis, then the cosine becomes negative, and if the point 
goes below the x-axis, the sine becomes negative 

Another property is that once a has got up to 2 n. the point is back where it started and the sine and 
cosine start taking the same values all over again, ie, SIN (a+2*PI) equals SIN a, and 

COS (a+2*PI) equalsCOS a. 

The tangent of a is defined as being the sine divided by the cosine, the corresponding function on the 
+3 iscaffedT AN 

Sometimes we need to work these functions out in reverse, finding the value of a that has given sine, 
cosine or tangent. The functions to do this are called arcsine (A S N on the +3), arccosine (ACS) and 
arctangent (A T N). 

In the diagram of the point moving round the circle, look at the radius joimng the centre to the point. 
You should be able to see that the distance we have called a (the distance that the point has moved 
round the edge of the circle) is a way of measuring the angle through which the radius has moved 
away from the x-axis, When a is equal to ir/2, the angle is 90 degrees; when a is equal to n the angle is 
180 degrees, and so on, round to when a is equal to 2 it, and the angle is 360 degrees, You might just as 
well forget about degrees, and measure the angle in terms of a alone; we say then that we are 
measuring the angle m radians Thus ir/2 radians is equal to 90 degrees and so on 

You must always remember that on the f3. the functions SIN, COS etc, use radians and net 
degrees To convert degrees to radians, divide by 180 and multiply by jr; to convert back from 
radians to degrees, you divide by n and multiply by 180 



Part 11 

Random Numbers 

Subjects covered.,. 

RANDOMIZE 

RND 

This section deals with the Keywords RND and RANDOMIZE 

In some ways R N D is like a function - it does calculations and produces a result It is unusual m that it 
does not need an argument. 

Cach time you use it, its result is a new random number between 0 and I. (Sometimes it can take the 
value 0, but never L) 

Try., 


10 PRINT RND 
20 GO TO 10 


to see how the answer vanes Can you detect any pattern? You shouldn't be able to - 'random' means 
that there is no pattern 

Actually, R N D is not truly random, because it follows a fixed sequence of 6S536 numbers. However, 
these are so thoroughly jumbled up that there are at least no obvious patterns, and we say that R N D is 

pseudo-random 

RND gives a random number between 0 and 1 but you can easily get random numbers m other 
ranges. For instance. 5* RN D is between 0and 5, and 1.3 + 0.7* RND is between 13 and 2. To 
get whole numbers use IN T (remembering that IN T always rounds down) as in 
1 + INT(RND*6). which we shall use it a program to simulate dice, RND *6 is in the range 0 to 6 
but since it never actually reaches 6 I NT( RND*6) isO. 1,2.3.4 or 5 

Here is the program 

10 REM dice throwing program 
20 CLS 

30 FOR n=1 TO 2 

40 PRINT 1+ INT ( RND *6);" 

50 NEXT n 

60 INPUT a $: GO TO 20 


Press ENTER each time you wish t' throw' the dice 
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The RANDOMIZE statement may be used to make R N D start off at a definite place m its sequence 
of numbers, as you can see with this program, 

10 RANDOMIZE 1 
20 FOR n=1 TO 5: PRINT RND 
NEXT n 

30 PRINT : GO TO 10 

After each execution of RANDOMIZE 1 , the RND sequence starts off agam with 0.0022735596. 
You can use other numbers between 1 and 65535 in the RANDOMIZE statement to start the R N D 
sequence off at different places. 

If you had a program with RND mit and it also had some mistakes that youhad not found, then it would 
help to use RANDOMIZE like this so that the program behaved the same way each time you ran it 

RANDOMIZE used on its own (or RANDOMIZE 0) have a different effect - they really do 
randomise R N D • you can see this in the next program. 

10 RANDOMIZE 

20 PRINT RND : GO TO 10 

The sequence you get here is not very random, because RANDOMIZE uses the time since 
the 4-3 was switched on. As this has gone up by the same amount each time thatRANDOMIZEis 
executed, the next RND does more or less the same You would get better randomness’ bv replacing 

GO TO 10byG0 TO 20 

Here is a program to toss coins and count the numbers of heads and tails... 

10 LET heads=0: LET taiLs = 0 
20 LET coi n = INT ( RND *2) 

30 IF coin=0 THEN LET heads=he 

ads +1 

40 IF coin=1 THEN LET tails=ta 

i Ls +1 

50 PRINT heads;",";tai Is, 

60 IF tails <> 0 THEN PRINT he 

ads/tai Is; 

70 PRINT: GO TO 20 

The ratio of heads to tails should become approximately 1 if you go on long enough, because in the 
long run you expect approximately equal numbers of heads and tails, 

Exercise 

! Choose a number between i and 872 and type 
RANDOMIZE your number 
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A 


Note that the next valueof R N D will be, 

(75*(yournumber+1 )-1)/65536 
Try this out for yourself. 
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Part 12 
Arrays 

Subjects covered... 

Arrays 

DIM 


Suppose that you have a list of numbers - tor instance, the ma r ks of ten people m a class, To store tnem 
mthe +3 you could use the variables ml m2, m3 .. and so on up to ml 0, but the program to set up 
these ten variables would be rather long and tedious to type in, ie 


10 

LET 

m 1 = 

75 

20 

LET 

m2 = 

44 

30 

LET 

m3 = 

90 

40 

LET 

m4 = 

38 

50 

LET 

m5 = 

55 

60 

LET 

m6 = 

64 

70 

LET 

m7= 

70 

80 

LET 

m 8 = 

12 

90 

LET 

m9 = 

75 

100 

LET 

m 10 

= 60 


Instead, there is a mechanism, known as an array whereby you may specify a vanable which (instead 
of containing a single value as variables normally do) may contain a number of separate elements, 
each of which may contain different values. Each element is referenced by an index number (the 
subscript) written in brackets afteT the vanable name. For the above example, the array variable's 
name could be m - (the name of an array vanable must be a single letter), and the ten variables would 
then be n (1), m (2) m (3) andsoonupto m (10) 

The elements of an array are called subscripted variables as opposed to the simple variables that you 
are already familiar with 

Before you can use an array, you must reserve some space for it in the +3's memory, and you do this 
by using the keyword DIM (for dimension). The statement, 

DIM m (1 0) 

...sets up an array called m whose dimensions are 10 (ie there are 10 subscnpted variables). The 
DIM statement initialises each element in the array to zero. It also deletes any array called m that 
existed previously - (however, it doesn't delete any simple vanable called m Ar array variable can 
coexist alongside a simple numencal vanable of the same name because the array can always be 
distinguished by its subscript) 
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The array elements' subscripts may be represented by any numencal expression yielding a valid 
subscript number. This means that an array can be processed using a FOR NEXT loop. Thus, 
instead of the above long-winded program, we can now set up the vanables m(1) m(10) 
using. 


10 

DIM 

m( 10) 


20 

FOR 

o 

h- 

n 

c 

10 

30 

READ 

m (n) 


40 

NEXT 

n 


50 

DATA 

75/44/ 

90/38,55,64/70,1 


2/75 

,60 


E AO 

in the elements' values 

i from a D A T A list, or 

10 

DIM 

m ( 10 ) 


20 

FOR 

n = 1 TO 

10 

30 

INPUT tn(n) 


40 

NEXT 

n 



. to IN P U T the elements' values by hand 

Note that the DIM statement must come before any attempt to access the array in a program. 
If you wish, you may examine the contents of the array using. 

10 FOR n=1 TO 10 
20 PRINT m(n) 

30 NEXT n 


.. orindividually using... 

PRINT m(1) 
PRINT m(2 ) 
PRINT m(3) 


etc 

You can also set up arrays with more than one dimension. In a two dimensional array you need two 
numbers to specif an element - rather like the line and column numbers that specify a character 
position on the screen. If you imagine the line and column numbers (two dimensions) as referring to a 
printed page, you could then for example, have an extra dimension to represent the page numbers 
Think of the elements of a three dimensional array V as bemg specified by V (page number/line 
number / column number). 
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For example, to set up a two-dimensional array c with dimensions 3 and 6, you use the DIM 
statement... 

DIM c(3,6) 

This then gives you 3x6= 18 subscripted vanables. 

0(1,1), c(1,2) toc(1,6) 
c (2,1), c (2,2) . to c (2,6) 
c(3,1) c(3,2) toc(3,6) 

The same principle works for any number of dimensions. 

Although you can have a number and an array with the same name, you cannot have two arrays with 
the same name, even if they have a different number of dimensions. 

There are also string arrays The strings in an array differ from simple strings in that they are of fixed 
length and assignment to them is always Procrustean (le chopped off or padded with spaces) 

The name of a string array is a single letter followed by $. Unlike numeric arrays a string array and a 
simple string variable cannot have the same name. 

Suppose then, that you want an array a $ of five strings. You must decide how long these strings are to 
be - let us suppose that 10 characters for each element is long enough, You then say., 

DIM a$(5,10) (typefhisin) 

This sets up a 5x10 array of characters, but you can also think of each row as being a string. 

a $ (1) equals a $ (1,1) a$(1,2) toa$(1,10) 
a $ (2) equals a $ (2,1) a$<2,2) ..toa$(2,10) 
a $ (3) equals a $ (3,1) a$(3,2) toa$(3,10) 
a $ (4) equals a $ (4,1) aJ(4,2) toa$(4,10) 
a $ (5) equals a $ (5,1) a$(5,2> . to a S < 5,10) 

fi you give the same number of subscripts (two in this case) as there were dimensions in the DIM 
statement, then you get a single character; but if you miss the last one out, then you get a fixed length 
string, So, for instance, a $ (2,7) is the 7th character in the string a $ (2) Using the slicing 
notation,we could also write this as a$ (2) (7) Nowtype, 

LET a$(2)="1234567890" 


...and... 


PRINT a $(2), a$(2,7) 


You get... 

1234567890 


7 
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Tor the last subscript (the one you can miss out), you can also have a sheer, so that forinstance 

a$(2,4 TO 8) isequaltoa$(2) (4 TO 8) isequalto "45678" 

Remember - In a string array, all the strings have the same fixed length. 

The DIM statement has an extra number (the last one) to specify this length. When you write down a 
subscripted variable for a string array, you can put in an extra number (a sheer j to correspond with the 
extra number in the DIM statement. 

You can have string arrays with no extra dimensions, Type.. 

DIM a$(10) 

. and you will find that a $ behaves just like a string variable, except that it always has length 10, and 
assignment to it is always Procrustean 


Exercise.. 

1 Use READ and DATA statements to set up an array m$ of twelve strings in which m$ (n) is the 
name of the nth month (Hint - The DIM statement will beDIM m $ (12,9) Test it by printing 
out all the values of m $ (n) (use a loop),) 
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Part 13 
Conditions 

Subjects covered... 

AND,OR 
NOT 

We saw m part 3 of this chapter how an IF statement takes the form,.. 

I F condition T H E N 

The conditions there were the relations =.<.>,<= >= and <> which compare two numbers oi two 
strings You can also combine several of these, using the logical operations; AND 0 R and N 0 T 

One relation AND another relation is true whenever both relations are true, so you could have a line 
like 

IF aS="yes" AND x>0 THEN PRINT "result" 

in which r e s u L t gets printed only if a $ is equal to y e s and x is greater than zero The BASIC 
here is so close to English that it hardly seems worth spelling out (he details. As in English, you can join 
lots of relations together with AND, and then the whole lot is true if all the individual relations are 

One relation 0 R another is true whenever at least one of the two relations is true. (Remember that it is 
still true if both the relations are true - this is something that English doesn't always imply) 

The NOT relationship turns things upside down. The NOT relalion is true whenever the relation us 
false, and false wheneverit is true 

Logical expressions may use combinations of A N D OR and NOT, just as numerical expressions may 
use combinations of +, * and so on. You can even put them in brackets if necessary. Logical 

opera lions have priorities in the same way as +, - * / and f do. NOT has the highest priority, then 

AND thenOR 

N 0 T is really a function, with an argument and a result, but its priority is much lower than that of other 
functions. Therefore, its argument does not need brackets unless it contains A N D or 0 R (or both). 
NOT a = bmeansthesameasNOT (a=b) (and the same as a <> bof course), 

< > is the negation of = m the sense that it is true only if = is false. In other words,.. 

aobisthesameasNOT a = b 

and also 

NOT aobisthesameasa^b 

Convince yourself that > = and < = are the negations of < and > respectively, Thus you can always 
get rid of N 0 T from m front of a relation by changing ihe relation 
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Also. 


N 0 T (a first. jgical expression A N D a second) 
. .is the same as. 

NOT (the first) 0 R N 0 T (the second) 
and. 


N 0 T (a first logical expression 0 R a second) 
is the same as. 

NOT (the first) AND NOT (the second) 

Using this, you can work N 0 T s through brackets until eventually they are all applied to relations, and 
then you can get nd of them. Logically speaking, NOT is unnecessary although you might still find 
that using it makes a program dearer 

The following section is quite complicated, and can be skipped by the faint-heartedl 
Try. 


PRINT 1=2,1 <> 2 

which you might expect to give a syntax error In fact, as far as the computer is concerned, there is 
no such thing as a logical value • instead it uses ordinary numbers, subject to a few rules, 

(ij =<,>,<=> = and < > all give the numeric results 1 for true, and 0 for false Thus, the P RIN T 
command above printed 0 for 1 =2, which is false, and 1 for 1 <> 2, which is true 

(n)ln the statement,. 


I F condition THEN 

. the condition can be actually any numeric expression. If its value is 0, then it counts as false, and any 
other value (including the value of! that a true relation gives) counts as true, Thus the IF statement 
means exactly the same as.. 

I F condition < > 0 T H E N 


(in) A N D. 0 R and N 0 T are also number-valued operations. 


x AND y has the value 
x OR y has the value 
NOT x has the value 




x if y is true (non-zero) 

0 (false), if y is false (zero) 

1 (true), if y is true (non-zero) 
x, if y is false (zero) 

0 (false), if x is true (non-zero) 
1 (true), if x is false (zero) 


(Notice that true' means non zero when we 1 re checking a given value, but it means 1 when we're 
producmg a new one). 
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Now try this program.. 


10 INPUT a 
20 INPUT b 

30 PRINT (a AND a >= b)+(b AND 
a< b) 

40 GO TO 10 

Each time it prints the larger of the two numbers a and b 
Convince yourself that you can think of 

X AND y 

... as meaning. 

x if y (else the result is 0) 

.and of, 

x OR y 


as meaning. 


X unless y (in which case the result is 1) 

An expression using AND or OR like this is called a conditional expression. An example using 0R 
could be 

LET total=price less tax*(1.15 OR v$="zero rated") 

Notice how AND tends to go with addition (because its default value is 0), and 0 R tends to go with 
multiplication (because its default value is 1). 

You can also make stnng valued conditional expressions, but only using AND 

x$ AND y has the value S ^ if ys non-zero 

[_ lfyiszero 

so it means x $ if y (else the empty stnng) 

Try this program, which inputs two strings and puts them in alphabetical ordei 

10 INPUT "type in two strings" 

1 a$,b$ 

20 IF a$> b$ THEN LET c$ = a$: L 
ET a$=b$: LET b$=c$ 

30 PRINT a$;" AND a$< b 

$) + ("=" AND a$ = b$);" ";b$ 

40 GO TO 10 
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Part 14 

The Character Set 

Subjects covered... 


CODE, CHR$ 

POKE,PEEK 

USR 

BIN 

The letters, digits, spaces, punctuation marks ana so on that can appear in strings are called 
characters, and they make up the character set that the +3 uses. Most of these characters are single 
symbols but there are some more, called tokens, that represent whole words, such as PRINT 
STOP, <>andsoon. 

There are 256 characters, and each one has a code between 0 and 255 (there is a complete list of them 
in part 28 of this chapter) To convert between codes and characters, there are two functions, CODE 
andCHRS 

C 0 D E is applied to a string, and gives the code of the first character in the string (or 0 if the string is 
empty), 

C H R $ is applied to a number, and gives the single character string whose code is that number 
This program pnnts out the entire character set.., 

10 FOR a = 32 TO 255: PRINT CHR$ 
a;: NEXT a 


On the screen will appear the following,, 



The character set 
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As you can see, the character set consists of a space, 15 symbols and punctuation marks the ten digits, 
seven more symbols, the capital letters six more symbols, the lower case letters and five more 
symbols. These are all (except £ and©) taken from a widely-used set of characters known as ASCII 
(American Standard Codes for Information Interchange) ASCII also assigns numeric codes to these 
characters, and these are the codes that the +3 uses. 

The rest of the characters are not part of ASCII, but are dedicated to the ZX Spectrum range of 
computers. First amongst them are a space and 15 patterns of black and white blobs. These are called 
the graphics symbols and can be used for drawing pictures You can enter these from the keyboard, 
using what's known as graphics mode Pressing the GRAPH key switches on graphics mode. after 
which the keys 1 2 3 4 5 6 7and8 willproducethegraphicssymbols.. 



While in graphics mode, pressing CAPS SHIFT together with one of the keys 1 to 8 produces 
'inverted' versions of the same symbols, le. black becomes white 3 nd white becomes black . 



The cursor keys won't work properly while all this is going on as the +3 interprets them as shifted 
number keys, and prints graphics characters accordingly 

Pressing the 9 key turns everything back to normal (as does pressing GRAPH again) The 0 key 
deletes the character to the left of the cursor 
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Here are the sixteen graphics symbols... 


Symbol Code Symbol Code 



128 

■ 

143 

3 

129 

L 

14? 

n 

liP 

a 

141 

H 

131 

H 

140 

□ 

13? 

r 

139 

a 

133 

E 

138 

EH 

134 

H 

137 

9 

13Ji 

□ 

136 


After the graphics symbols in the character set, you will see what appears to be another copy of the 
alphabet from A to S, These are characters that you can redefine yourself (though when the machine is 
first switched on they are set as letters) • they are called user-defined graphics You can type these in 
from the keyboard by gomg into graphics mode, and then using the letter keys A to S 

To define a new character for yourself, follow this recipe - it defines a character to show 
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(l) Work out what the character looks like. Each character has an 8 x 8 grid of dots, each of which can 
appear to be either on or off You’d draw a diagram something like this (with black squares 
representing the dots which are on).. 



When a dot is on. the +3 prints the ink colour, when a dot is off the +3 prints the paper colour 
(The terms ink and paper are explained in part 16 of this chapter. ) 

We've left a one-square border around the edge of the character because all the other letters also 
have one (except for lower case letters with tails, where the tail goes right down to the bottom), 

(a) Work out which user-defined graphic you wish to display it - let’s say the one corresponding to P 
so that if you press P (after pressing GRAPH) you get n 

(m) Store the new pattern. Each user-defined graphic has its pattern stored as eight numbers, one for 
each row. You can write each of these numbers m a program as BIN followed by eight 0’s or I s - 0 for 
paper, 1 forink - so the eight numbers for our ir character are 


BIN 00000000 
BIN 00000000 
BIN 00000010 
BIN 00111100 
BIN 01010100 
BIN 00010100 
BIN 00010100 
BIN 00000000 


-top row 

-second row down 
-third row down 
-fourth row down 
-fifth row down 
-sixth row down 
-seventhrow down 
-bottom row 


(If you know about binary numbers, then it should help you to know that BIN is used to write a 
number in binary instead of the usual decimal.) Look at the pattern of binary numbers through 
half-closed eyes - you may even be able to see the rr character 


These eight numbers are stored m eight locations (bytes) m memory. Each of these locations has an 
address The address of the fust byte (or group of eight digits) is U S R " P " (we chose P in (n) 
above) The address of the second byte is U S R " P " +1, and so on up to the eighth byte, which has 
the address U S R " P " + 7 
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U S R here is a function fo convert a string argument into the address of the first byte in memory for the 
corresponding user-defined graphic The string argument must be a single character which can be 
either the user-denned graphic itself or the corresponding letter (in upper or lower case). There is 
another use for U S R when its argument is a number, which will be dealt with later, 

Even if you don't understand this, the followmgpiogram will define the character for you 


10 

FOR 

S3 

II 

d 

TO 7 

20 

READ 

row 

: POKE USR "P"+n, r 

30 

40 

ow 

NEXT 

DATA 

n 

BIN 

00000000 

50 

DATA 

BIN 

00000000 

60 

DATA 

BIN 

00000010 

70 

DATA 

BIN 

00111100 

80 

DATA 

BIN 

01010100 

90 

DATA 

BIN 

00010100 

100 

DATA 

BIN 

00010100 

110 

DATA 

BIN 

00000000 

The POKE 

statement stores a number directly in a memory location, bypassing the mechanisms 


normally used by the BASIC The opposite r’ - POKE is PEEK and this allows us to look at the 
contents of a memory location although it does not actually alter the contents themselves P E E K and 
P 0 K E are described more fully m part 24 of this chaptei 

Attei the user -defined graphics in the character set come the tokens 

You will have noticed that we have not printed out the first 32 characters (codes 0 to 3i) - these arc 
control characters They don't produce anything printable, but instead are used to control the scree:, 
display or some other function of the +3 

(If you try to print control characters, the +3 displays ? to show that it doesn't understand them 
Control characters are described more fully in part 28 of this chapter) 

The three control characters that the screen display uses are 6. 8 and 13 (these will now be 
explained) Onthewhoir CHRS 8istheonlyoneyouareltkelytohnduseful 

CHRS 6 prints spaces in exactly the same way as a comma does in a PRINT statement, lot 
instance. 

PRINT 1; CHRS 6;2 

.does the same as 

PRINT 1,2 

Obviously this is not a very clear way oi usingit. A more subtle way is to say 

LET a$ = "1"+ CHRS 6 + "2" 

PRINT aS 
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C H R $ 8 is 'backspace - it moves the prmt position back one place. Try 

PRINT "1234"; CHR$ 8;"5" 

which prints out. 

1235 

C H R $ 13 is newline • it moves the print posmon to the beginning of the next line 

The screen display also uses control codes 16 to 23 ■ these are explained in parts 15 and 16 of this 

chapter (all the codes are listed in part 28). 

Using the codes for the characters we can extend the concept of 'alphanumerical ordering' to cover 
strings containing any characters, not j ust letters. If instead of thinking in terms of the usual alphabet of 
26 letters we use the extended alphabet of 266 characters, m the same order as their codes, then the 
principle is exactly the same. For instance, the following strings are in their 'Spectrum' ASCIi 
alphabetical order. (Notice the rather odd feature that lower case letters come after all the capitals; so 
a comes after Z Notice also that spaces are significant) 

CHR$ 3 + "ZOO LOGICAL GARDENS" 

CHR$ 8+"AARDVARK HUNTING" 

" AAAARGH!" 

"(Parenthetical remark)" 

" 100 " 

"129.95 inc. VAT" 

"AASVOGEL" 

"Aardvark" 

"Elgar, the Regal Lager" 

"PRINT" 

"Zoo" 

"[interpolation]" 

"aardvark" 

"aasvoge l" 

"derby" 

"zoo" 

"zoology" 

Here is the rule for finding out in which order two strings come. Start by companng the fust two 
characters, if they are different, then one of them has its code less than the other, and the string it 
comes from is the earlier (lesser) of the two strings. If they are the same, then go on to compare the 
next two characters, If in this process one of the strings runs out before the other then that string is the 
earlier; otherwise they must be equal. 

The relations =, <, >, <=, > = . and < > are used for strings as well as for numbers, < means comes 
before and > means 'comes after', so that. 

"AA man"<"AARDVARK" 

"AARDVARK">"AA man" 

. are both true. 
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< = and > = work the same way as they do for numbers, so that.. 

"The same string" <= "The same string" 

...is true, but.. 

"The same string" < "The same string" 

.is false. 

Experiment on all this using the program here, which inputs two strings and puts them in order. 

10 INPUT "Type in two strings: 

",a$,b$ 

20 IF a$> bS THEN LET c$=a$: L 
ET a$=b$: LET b$=c$ 

30 PRINT a$;" 

40 IF a$< b$ THEN PRINT 
GO TO 60 
50 PRINT "="; 

60 PRINT " ";bS 
70 GO TO 10 

Note (in the above program and also in the program at the end of part 13) how we have to introduce 
c $ in line 20 when we swap over a $ and b $ . Can you see why simply usmo. 

LET a$=b$: LET b$=a$ 

would not have the desired effect’ 

The next program sets up user defined graphics for the following keys to display chess pieces 

B for bishop 
K for king 
R for rook 
Qforgueen 
P for pawn 
N for knight 

Chess pieces 

5 LET b=BIN 01111100: LET c=B 
IN 00111000: LET d=BIN 0001 
0000 

10 FOR n=1 TO 6: READ p$: REM 
6 pieces 

20 FOR f=0 TO 7: REM read piec 
es into 8 bytes 
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30 READ a: POKE USR p$ + f, a 

40 NEXT f 

50 NEXT n 

100 REM bishop 

110 DATA "b", 0, d, BIN 0010100 
0, BIN 01000100 

120 DATA BIN 01101100, c, b, 0 

130 REM king 

140 DATA "k", 0, d, c, d 

150 DATA c, BIN 01000100, c, 0 
160 REM rook 

170 DATA "r", 0, BIN 01010100, 

b, c 

180 DATA c, b, b, 0 
190 REM queen 

200 DATA "q", 0, BIN 01010100, 

BIN 00101000, d 

210 DATA BIN 01101100, b, b, 0 

220 REM pawn 

230 DATA "p", 0, 0, d, c 

240 DATA c, d, b, 0 
250 REM knight 

260 DATA "n", 0, d, c, BIN 0111 

1000 

270 DATA BIN 00011000, c, b, 0 

Note that m the above DATA statements, we have simply used 0 instead of BIN 00000000 
When you have run this program, you may look at the pieces by pressing GRAPH tallowed by any of 
the keys B K R Q Pot N 

Exercises. 

. Imagine the space for one symbol divided up into four 'quarters like a Battenberg cake Then it each 
quarter can be either blacker white therearef-" = !6 possibilities Find them all in the character set 

2 Run this program 

10 INPUT c 
20 PRINT CHRS c; 

30 GO TO 10 

If you experiment with it, you ii find that CHRS c is rounded to the nearest whole number, and if c is 
not it the range 0 to 255 then the program stop? with the error renon B integer out of 
range 

3, Which of these is the lesser 1 

"EVIL" 

"evi l" 
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Part 15 

More about PRINT and INPUT 

Subjects covered... 

CLS 

PRINT items 

Expressions (numeric or string type) 
TAB numeric expression 
A T numeric expression 
PRINT separators , ; 1 
INPUT items 

Variables (numeric or string type) 
LINE string variable 
Scrolling 
SCREENS 


You have already seen PRINT used quite a lot. so you will have a rough idea of how it is used 
Expressions whose values are printed are called PRINT items They may be separated by commas, 
semicolons or apostrophes which are called PRINT separators A PRINT item can also be 
nothing at all, which is a way ofexplairung what happens when you use PR IN T on its own. 

There are two more lands of P RIN T items, which are used to tell the +3 not what, but where to 
print. For example, the instruction, 

10 PRINT AT 11,16;"*" 

.. pnnts an astenx * m the centre of the screen. Thisisbecause 
AT line,column 

moves the P RIN T position (the place where the next item is to be printed) to the line and column 
specified. Lines are numbered from 0 (at the top) to 21 columas are numbered from 0 (on the left) to 

SCREENS is the reverse function to PRINT AT and -will (within limits) 'read' the character 
which is located at a particular position on the screen. It uses line and column numbers in the same 
way as PRINT AT, but enclosed in brackets. For example, the instruction. 

20 PRINT AT 0,0; SCREENS (11,16) 

. will read the astenx printed in the centre of the screen then print it at location 0,0 (the top left-hano 
comer) 
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Characters from tokens are read normally (as single characters), and spaces are read as spaces. 
However, attempting to read user-defined characters, graphics characters, or lines drawn by P L 0 T. 
DRAW and CIRCLE, result in a null (empty) string being returned. The same applies if 0 V E R has 
been used to create a composite character (The keywords PLOT, DRAW, CIRCLE and OVER 
are described m parts 16and 17 of this chapter.) 


You cannot normally PRINT or PLOT 
on the bottom two lines 

























The function. 

T A B column 

prints enough spaces to move the PRINT position to the column specified. It stays on the same 
line, or, if this would involve backspacing, moves to the next line. Note that the +3 reduces the 
column number modulo 32' (le. it divides by 32 and takes the remainder) - so T A B 33 means the 
sameasTAB 1 

As an example. 

PRINT TAB 30;1; TAB 12;"Contents 
AT 3,1;"Chapter"; TAB 24;"Pag 


. is how you might want to print out the heading on the contents page (page i) of a book. 

Try running this... 

10 FOR n = 0 TO 20 
20 PRINT TAB 8*n;n; 

30 NEXT n 

This shows what is meant by the T A B numbers being reduced modulo 32. 

Fora more elegant example, change the 8 in line 20 to a 6 
Note the following points . 

(i) TABs and print items are best terminated with semicolons as we have done above. You can use 
commas (or nothing, at the end of the statement), but this means that after having carefully sc-l up the 
PRINT position, you immediately move it on again - not terribly useful! 

(u) 1 ou cannot print on the bottom two lines (22 and 23) on the screen because they are reserved for 
commands, INPUT data, reports, error messages and so on. References to the bottom line usually 
mean line 21 

(m) You can use A T to locate the PRINT position even where there is already somethma printed 
-the new pnntitem will simply overwnte the ola 

Another statement connected with PRINT is CLS This clears the whole screen 

When pointing reaches the bottom of the screen, it starts to scroll upwards rather like a typewriter 
You can see this if you go into the small screen using the edit menu option Screen (described in 
chapters), and then type... 

CLS: FOR n=1 TO 30: PRINT n: NEXT n 

When it has printed a screen full, the +3 will stop with the message sc rot. I? at the bottom of the 
screen You ran now inspect the first 22 numbers at your leisure When you have finished with them, 
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press Y (for yes) and the +3 will give you the next screen full of numbers Actually, any key will 
make the +3 carry on except N (for no), the BREAK key or the space bar. These will make 
the +3 stop running the program with ihe report DBREAK-CONT repeats 

The INPUT statement can do much more than we have told you sc far You have already seer. 
INPUT statements like,,. 

INPUT "How old are you?", age 

m which the +3 prints the caption Howoldareyou?atthe bonom of the screen, and then 
you have to type in your age In fact though an INPUT statement can be made up of items and 
separators in exactly the same way as a PRINT statement, so How old are you? and age 
are both INPUT items INPUT items are generally the same as P RIN T items, however there 
are some very important differences, 

first, an obvious extra INPUT item is the variable whose value you require to be typed in agem 
our example above. The rule is that if an IN P U T item begins with a letter, then it must be a variable 
whose value is to be input 

This would seem to mean that you can't pnnt out the values of variables as part of a caption. However 
you can get round this by putting brackets around the variable Any expression ihar starts with a letter 
must be enclosed tn brackets if it is to be printed as part of a caption, 

Any kind of PRINT item that is not affected by these rules is also an INPUT item Here is an 
example to illustrate what's going on 

LET my age = INT ( RND * 100): I 
NPUT ("I am ";my age;".");" How 
old are you?", your age 

my age is contained m brackets, so us value gets printed out your age is not contained m 
brackets, so you have to type its value in 

Everything that an INPUT statement writes goes to the bottom part of the screen which acts 
somewhat independently of the top part. In particular, its .ines are numbered relative to the top line of 
the bottom halt even if this has moved up the actual TV screen (which it does if you type lots of 
INPUT data). Whatever the small screen does during INPUT however it will always revert to 
being two lines in size when the program stops, and you start editing 

To see how AT works m INPUT statements, try this 

10 INPUT "This is line 1.",a$; 

AT 0,0;"This is line 0.",a 
$; AT 2,0;"This is line 2." 

,a$; AT 1,0;"This is still 
line 1.",a$ 

Run the program Oust press ENTER each time :t stops}. When This is line 2 is printed, the 
lower part of the screen moves up to make room for it but the numbering moves up as well, so that the 
lmesof text keep then same numbers 
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Now tty this.. 


10 

FOR n 

= 0 

TO 19: 

PRINT AT n. 

0 


; n; : 

NE 

XT n 



20 

INPUT 

A 

T 0, 0; 

a$; AT 1, 0; 

a$ 


; at 

2, 

0;a$; 

AT 3, 0;aS; 

AT 


4, 0 

; a 

$; AT 5 

/ 0;a$; 



As the lower part of the screen goes up and up, the upper part remains undisturbed unul the lower 
part threatens to write on the same line as the P RIN T position Then the upper part starts scrolling 
up to avoid this, 

Another refinement to the INPUT statement that we haven't seen yet is called LINE input and is a 
different way of inputting string variables. If you use LINE before the name of a string variable to be 
input, as in 

INPUT LINE a$ 

then the +3 will not give you the string quotes that it normally does for a string variable (though it 
will pretend to itself that they are there) So if you type 1 n 

bugs 

as the INPUT data a $ will be given the value bugs. Because the string quotes do not appear 
with the string, you cannot delete them and type lnadifferentsortofstnngexpressionfor the INPUT 
data Remember that you cannot use LIN E for numeric variables 

There's an interesting side effect to INPUT Whilst typing into an INPUT request, the old 
Spectrum sing le-key entry system enjoys a brief moment of freedom before being locked away again 
when you press ENTER Run this program if you're interested 


10 

INPUT 

numbers 

20 

PRINT 

numbers 

30 

GO TO 

10 


Input a few numbers, and they'll be printed faithfully onto the screen Now press EXTEND MODE 
followed by the M key, i’he word PI appears, and if you press ENTER, then 3.1415927 will 
appear as if by magic However, if you type P I as two letters without the .aid of EXTEND MODE ihen 
the +3 will stop with the report 2 Variable not found, 10:1 

There's no simple explanation for this behaviour, and it's best just ro be aware that it can happen if you 
press some combinations of keys during INPUT If ior some reason you're keen to experiment 
chapter 7 (Using 48 BASIC) will tell you which keys produce which effects 
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The control characters CHR$22andCHR$23 have effects rather like A T and T A B Whenever 
the +3 is instructed to print one of them, the character must be followed by two more characters that 
do not have their usual effect, but that are treated instead as numbers (Iheir codes) to specify the line 
and column (for A T) or the tab position (for TAB). You will almost always find it easier to use A T and 
T A B m the usual way rather than use control characters, however, they might be useful in some 
circumstances. The A T control character is C H R S 2 2 The first character after it specifies the fine 
number and the second specifies the column number, so that,, 

PRINT CHR$ 22+ CHR$ 1+ CHR$ c; 

., has exactly the same eff ect as. 

PRINT AT 1, c; 

This is sc that even lfCHRS 1 orCHRS c would normally have a different meaning (for instance li 
c -1 3 ,' the C H R $ 2 2 before them overrides that. 

The TAB control character is C H R $ 23 and the two characters after it combine to give a number 
between 0 and 65S3S, specifying the number you would have in a T A B item. The statement.. 

PRINT CHR$ 23+ CHRS a+ CHR$ b; 

has the same effect as 

PRINT TAB a+256*b; 

You can use POKE to stop the computer askmgif you wish to scroll? by typing., 

POKE 23692, 255 

every so often After this it will scroll up 255 times betore stopping with s c r o 11 ? As an example, 
try 

10 FOR n = 0 TO 1000 
20 PRINT n: POKE 23692,255 
30 NEXT n 

. and watch everything whizz off the screen' 

Efitercise,, 

1, Try this program on some children, to test their multiplication tables... 


10 

LET 

m$="" 


20 

LET 

a= INT ( RND *12)+1: 

LE 


T b 

= INT ( RND * 12) +1 


30 

INPUT (m$) ' ' "what is ' 



a);" 

x (b);c 


100 

IF c 

=a*b THEN LET m$="Right 


H. 

GO TO 20 


110 

LET 

m$="Wrong. Try again, 

M . 


GO TO 30 
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If they are perceptive, they might manage to work out that they do not have to do the calculation 
themselves. For instance, if the +3 asks them to type the answer to 2 x 3, then all they have to do is 
type in 2 * 3 literaLy. 
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Part 16 
Colours 

Subjects covered... 

INK, PAPER, FLASH, BRIGHT, INVERSE, OVER 
BORDER 


Run this program 




10 

FOR m=0 

TO 1 

: BRIGHT 

m 

20 

FOR n=1 

TO 1 

0 


30 

FOR c — 0 

TO 7 



40 

PAPER c 

: PRI 

NT " 

; : REM 


4 co Lo 

ured 

spaces 


50 

NEXT c: 

NEXT 

n: NEXT 

m 

60 

FOR m=0 
ER 7 

TO 1 

: BRIGHT 

m: PAP 

70 

FOR c=0 

TO 3 



80 

INK c: 

PRINT 

r . It H . 

u / s 


90 

NEXT c: 

PAPE 

R 0 


100 

FOR c=4 

TO 7 



110 

INK c: 

PRINT 

. .ii M . 

'-Z l 


120 

NEXT c: 

NEXT 

m 


130 

PAPER 7 

: INK 

0: BRIGHT 0 


This shows the eight colours (including white and black) and the two levels of brightness th:.t the +3 
can produce on a colour TV (1! your TV is black-and white, then you will see just various shades of 
grey.) A quicker way to achieve a similar result is to RESET the +3 whilst holding down BREAK 
but that's a little drastic Here is a list cf which numbers produce which colours (for your reference} 


0- black 
1 - blue 
2-red 
3 magenta 

4- green 

5- cyan 

6 - yellow 

7 white 

On a black-and-white TV these numbers are in order of brightness To use these colours properly 
you need to understand a bit about how the picture is arranged 
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The picture is divided up into 768 (24 lines of 32) positions (ceils) where characters can be printed. 



A typical character cell 


Each character cell consists of an 8 x 8 grid (such as above). This should remind you of the 
user-defined graphics in parr 14, where we had Os for the white dots and Is for the black dots. 

The character has two colours associated with it: the ink, or foreground colour which is the colour for 
the black dots in our square, and the paper, or background colour, which is used for the white dots To 
start off with, every cell has black ink and white paper so writing appears as black on white 

The character also has a brightness (normal or extra bright), and something to say whether it flashes 
or not. Flashing is done by continuously swapping the ink and paper colours All this information can 
be coded into numbers, so a character then has the following,,. 

(i) An 8 x 8 grid of Os and Is to define the shape of the character, with 0 for paper and 1 for ink. 

(ii) Ink and paper colours, each coded in to a number between 0 and 7 
(in) A brightness - 0 for normal, i for extra bnght 

(iv) A flash number - 0 for steady, 1 for Dashing 

Note that since the ink and paper colours cover a whole character cell, you cannot possibly have more 
than two colours in a given block of 64 dots. The same goes for the brightness and flash numbers - they 
refer to the whole character cell, not individual dots within the cell. The colour, brightness and flash 
number for a given character cell are called attributes 
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When you pnnt something on the screen, you change the dot pattern for that character cell, It is less 
obvious, but still true, that you also change the cell's attributes. To start off with you do not notice this 
because everything is printed with black ink on white paper (at normal brightness and no Sashing); 
however, you can vary this with the INK, PAPER, BRIGHT and FLASH statements, Using the 
edit menu's Screen option, go to the bottom screen, and try. 

PAPER 5 

,., and then PRINT a few items on the screen - they will appear on cyan paper, because as they are 
printed, the paper colour for the cells they occupy are set to cyan (which has code 5) 

The others work the same way, so you may use the settings.,, 


PAPER (whole number between 0 and 7) 

INK (whole number between 0 and 7) 

BRIGHT (whole number between 0 and 1) 

FLASH (whole number between 0 and 1) 

and any printing will set the corresponding attributes for all the character cells it subsequently uses 

Try some of these out. You should now be able to see how the program at the beginning of this secnon 
worked (remember that a space is a character that has its ink and paper the same colour ) 

There are some more numbers you can use m these statements that have less direct effects, 

8 can be used in all four statements, and means transparent in the same sense that the old attribute 
shows through. Suppose, forinstance, that you do, 

PAPER 8 

No character position will ever have its paper coiour set to 8 because there is no such colour; what 
happens is that when a position is printed on, its paper colour is left the same as it was before. 
However. INK 8, BRIGHT 8 and FLASH 8 work the same way as lor the other attribute 
numbers, 

9 can be used only with PAPER and INK, and means 'contrast'. The colour (ink or paper) that you 
use it with is made to contrast with the other by being made white if the other is a dark colour (black, 
biue, red or magenta), or being made black if the other isa light colour (green, cyan, yellow or white). 

Try this by doing. 

INK 9: FOR c=0 TO 7: PAPER c: PRINT c: NEXT c 

A more impressive display of its power is to run the program at the beginning to make coloured 
stripes (again, making sure that you are m the lower screen when you type R U N ), and then domg. 

INK 9: PAPER 8: PRINT AT 0, 0;: 

FOR n = 1 TO 1000: PRINT n; : NEXT n 

The ink colour here is always made to contrast with the old paper colour for each character cell. 
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Coloui TV relies on the fact lhat the human eye need see only three colours of light (red, qreen and 
blue) in various combinations and intensities in order to perceive all the colours of the spectrum The 
+3 also displays its spectrum of colours by using mixtures of red. green and blue. For instance, 
yellow is made by mixing red with green - which is why its code 6. is the sum of the codes for red and 

green 

To see now all eight colours fit together, imagine tnree rectangular spotlights, coloured red. green 
and blue shining at not quite the same place on a piece of white paper in the dark Where they overlap 
you will see mixtures of colours, as shown by the following program (note that solid ink spaces are 
obtained by entering graphics mode (pressing GRAPH) then holding down CAPS SHIFT while 
pressing 8. To exit from graphics mode, press 9 

10 BORDER 0: PAPER 0: INK 7: C 
LS 

20 FOR a=1 TO 6 _ 

30 PRINT TAB 6; INK 1; "HBHI 

REM 18 ink sq 

ua res 
40 NEXT a 

50 LET dataline=200 
60 GO SUB 1000 
70 LET dataline=210 
80 GO SUB 1000 
90 STOP 

200 DATA 2,3 / 7,5 / 4 
210 DATA 2,2,6,4,4 
1000 FOR a = 1 TO 6 
1010 RESTORE dataline 

1020 FOR b=1 TO 5 _ 

1 030 READ c: PRINT INK 

: REM 6 ink squares 
1040 NEXT b: PRINT: NEXT a 
1050 RETURN 

Thete is a function called ATTRihai finds out what the attributes are at a given position on thescreen 
Ihs a fairly complicated function, so it has been relegated to the end of this section 

Thereaietw. more statements I NVERSE and OVER which contri not the attributes but the-dot 
pattern that is printed on the screen They use the numbers ft t alt and 1 for on If you use 
INVERSE 1. then each character cell's dot pattern will be the inverse of its usual form, le paper 
dots will be replaced by ink dots and vice versa Thus the character cell containing a (shown 
previously) would be printed as follows)'?!: the nexl page) 
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If (as al switch on) we have black ink and white paper then the a will appear as white on black. 
The statement 

OVER 1 


sets into action a particular sort of overprinting. Normally when something is written into a character 
position, it completely obliterates what was there before; however, using OVER 1. the new 
character is simply added on top of the old one. This can be particularly useful for writing composite 
characters, like an underlined letter, as in the following program. (Reset the computer and select 
+ 3 BASIC Note that the underline character is obtained by pressing SYMB SHIFT together with 
0 ).. 


10 OVER 1 

20 PRINT "w"; CHR$ 8; 

(Notice we have used the control character C H R S 8 (backspace) before overprinting the wwith_ 

There is another way of using IN K. P A P E R and so on which you will probably find more useful than 
having them as statements You can put them as items m a P RIN T statement (followed by ;), and 
they then do exactly the same as they would have done if they had been used as statements on their 
own, except that then effect is only temporary, lasting as far as the end of the P RIN T statement that 
contains them, Thus if you type.. 

PRINT PAPER 6;"x"; : PRINT "y" 

then only the x will be on yellow paper 
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PAPER, INK, etc, when used as statements do not affect the colour in the bottom part of the screen 
(where IN P U T data is typed in and reports are displayed) The bottom screen uses the colour of the 
border for its paper colour, code 9 (for contrast) for its ink colour, has Dashing off, and everything at 
normal brightness You can change the border colour to any of the eight normal colours (not 8 ot 6) 
using the statement. 

BORDER cotour 

When you type m IN P U T data, it follows this rule of using contrasting ink on border coloured paper; 
but you can change the colour of the captions written by the +3 by using PAPER, INK, etc items 
m the IN P U T statement, just as you would in a P RIN T statement. Their effect lasts either to the end 
of the statement, or until some IN P U T data is typed in. whichever comes soonest Try 

INPUT FLASH 1; INK 4;"Enter a number?";n 

The +3 has a high regard for your sanity - no matter what combination of effects and colours you 
manage to produce from a BASIC program, the editor will always use black ink on white paper 

There is one more way of changing the coiours by using control characters - rather like the control 
characters for A T and T A B m part 15 


CHR$ 

16 

corresponds to 

INK 

CHR$ 

17 

corresponds to 

PAPER 

CHRS 

18 

corresponds to 

FLASH 

CHR$ 

19 

corresponds to 

BRIGHT 

CHRS 

20 

corresponds to 

INVERSE 

CHRS 

21 

corresponds to 

OVER 


These are each followed by one character that shows a colour by its code, so that (for instance), 

PRINT CHR$ 16+ CHR$ 9;"item" 

has the same effect as 

PRINT INK 9; "i tern 1 ' 

On the whole, you would not bother to use these control characters because you might just as well use 
the statements PAPER, IN K etc However if you have some old 48K BASIC programs on cassette, 
you may find such control characters embedded in the listing. In general, the editor will actively 
ignore them and remove them at the first opportunity. It is not possible to insert them into listings as 
with the old 48K Spectrum. 

The A T T R function has the form 
ATTR (line,column) 
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Its two arguments are the line and column numbers that you would use in an A T item, and its result is a 
number that shows the colours and so on at the corresponding character position on the TV screen 
You can use this as freely m expressions as you can any other function 

The number that is the result is the sum of four other numbers as follows. 

128 if the character cell is flashing 0 if it is steady 

64 if the character cel! is bright 0 if il is normal 

6 multiplied by the code for the paper colour 

multiplied by the code for the mx colour. 

F nr instance if the character cell is flashing normal brightness, yellow paper and blue ink ihen the 
tour numbers that we nave tc add together are .28 0.8x6=48 ana I making 177 altogether Test this 
with 

PRINT AT 0,0; FLASH 1; PAPER 6; 

INK 1;" ATTR (0,0) 

Flxercises 

Try 


PRINT "B"; CHR$ 8; OVER 1;"/"; 

Where the / h,n cut through tho B it has left a white dot. This is the way that overprinting works on 
the +3 - two papeis or two inks give a paper one of each gives an ink This has the interesting 
property 'hat if you overprint with the same thing twice you end up with what you had at the 
beginning tf you r.cv; type 

PRINT CHR$ 8; OVER 1;"/" 

■ nya p.j r-~ -r •..«!. t. sir a B 


■ Fur. this ptogr. r 


10 POKE 22527+ RND *704, RND * 

127 

20 60 TO 10 

Never rr.ir.ci h v;*hisprc tr.tr:. w 'tvs The pt::u im is changing the r . ' its of squares on the TV 
! ' 1 lilt RND : . 

ntu-i v ; i- • rr nr' p th< • m • i itterr.r. RND le pseudo-randominsteau "(truly 

i melon; t 
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Part 17 
Graphics 

Subjects covered... 

PLOT,DRAW,CIRCLE 
Pixels 

For all of this section, type in the example programs, commands and R U N m the small screen (use the 
edit menu's Screen option) 

In this section we shall see how to draw pictures on the +3. The part of the screen you can use has 22 
lines and 32 columns, making 22x32=704 character positions, As you may remember from part 16 
each of these character positions is made up of an 8 x 8 grid of dots which are called pixels (picture 
elements). 

A pixel is specified by two numbers - its coordinates. The first, its x coordinate, says how far it is across 
from the extreme left-hand column The second, its y coordinate, says how far it is up from the bottom. 
These coordinates are usually written as a pair in brackets, so (0,0) (225,0) (0,175) and (255,175) are the 
bottom left, bottornnght top left ar.d top right corners of the screen. 

If you have trouble memorising which coordinate is which, simply remember that xis a cross (x is 
across). 

The statement 

P L 0 T x coordinate , y coordinate 
inks in the pixel with these coordinates, so this measles program. 

10 PLOT INT ( RND *256), INT ( 

RND *176): INPUT a$: GO TO 
10 

plots a random point each time you press ENTER 

Here is a rather more interesting program. It plots a graph of the function SIN (a sme wa ve) for values 
between 0 and 2 it... 

10 FOR n=0 TO 255 

20 PLOT n, 88+80* SIN (n/128* 

PI ) 

30 NEXT n 

This next program plots a graph of S Q R (part of a parabola) between 0 and 4 

10 FOR n=0 TO 255 
20 PLOT n, 80* SQR (n/64) 

30 NEXT n 
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Notice that pixel coordinates are rather different from the line and column in an A T item You may find 
that the diagram in part 15 of this chapter Is useful when working out pixel coordinates and line and 
column numbers. 

To help you with your pictures, the + 3 will draw straight fines, circles and parts of circles for you, 
using the D R A W and CIRCLE statements, 

The statement D R A W (to draw a straight fine) takes the form 

DRAW x,y 

The starting place of the line is the pixel where the last P LOT, DRAW or CIRCLE statement left off 
(this is called the PLOT position - RUN, CLEAR, CLS and NEW reset it to the bottom left-hand 
comer at 0,0), the finishing place of the fine is x pixels to the right of that and y pixels up. The DRAW 
statement on its own determines the length and direction of the line, but not its starting point. 

Experiment with a few P L 0 T and D R A W commands, for instance 

PLOT 0,100: DRAW 80,-35 
PLOT 90,150: DRAW 80,-35 


Notice that the numbers in a D R A W statement can be neganve, but those « a P L 0 T statement can’t 

You can also plot and draw in colour, although you have to bear in mind that colours always cover the 
whole of a character cell and cannot be specified for individual pixels. When a pixel is plotted, it is set 
to show the full mk colour, and the whole of the character cell containing it is given the current ink 
colour This program demonstrates that point... 


10 

BORD 

ER 0 

: PAPE 

R 


0: INK 

7: 

C 


LS: 

REM 

black 

0 

u 

t sere 

en 


20 

LET 

x1=0 

: LET 

y 

1 

= 0: RE 

M s 

ta 


rt o 

f Li 

ne 






30 

LET 

c = 1 : 

REM f 

0 

r 

ink c 

o lo 

u r 


, St 

a rt i 

ng b lu 

e 





40 

LET 

x2 = 

INT ( 

RN 

D *256 

): 

LE 


T y2 

= INT ( RN 

D 


*176) : 

RE 

M 


rand 

om f 

i ni sh 

0 

n 

line 



50 

DRAW 

INK 

c; x2- 

X 

1 

/y2-y1 



60 

LET 

x 1 =x 

2: LET 


y 

1 =y2: 

REM 

n 


ext 

line 

start 

s 


where 

las 

t 


one 

f i n i 

shed 






70 

LET 

c = c + 

1: IF 

c 

= 

8 THEN 

LE 

T 


c = 1: 

REM 

new c 

0 

i 

our 



80 

GO T 

0 40 
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The lines seem to get broader as the program goes on. and this is because a line changes the colours 
of all the inked-m pixels of all the character cells that it passes through Note that you can embed 
PAPER INK FLASH BRIGHT INVERSE and OVER items in a PLOT or DRAW 
statement just as you could with PRINT and INPUT They gc between the keyword and the 
coordinates, and are terminated by either semicolons or commas 

An extra frill with D R A W is that you can use it to draw parts of circles instead of straight lines, by 
including an extra number to specify an angle to be turned through The form is,, 

DRAW x,y,a 

x and y are used to specify the finishing point of the line just as before, and a is the number of radians that it 
must turn through as it goes. If a is positive then it turns to the left, if a is negative then it turns to the nght 
Another way of seeing a is as showing the fraction of a complete aide that will be drawn, (a complete circle 
is 2ir radians) so if a equals - it will draw a semicircle, if a equals O.Sxir a quarter of a arcle, and so on. 

For instance, suppose a equals rr Then whatever values x and y take, a semicircle will be drawn 
Try, 

10 PLOT 100,100: DRAW 50,50, PI 

which will draw this,, 



The drawing starts off in a south-easterly direction, but by the time it steps, it is gomg north-west. In 
between, it has turned through 180 degrees, or n radians (the value of a) 

Run the program several times, with PI replacen by various other expressions eg -PI, PI / 2 
3*PI/2 PI/4,1.0 etc. 

The last statement in this section is CIRCLE which draws an entire circle. You speafy the 
coordinates of the centi e and the radius of the circle using 

CIRCLE xcoordinate, ycoordinate, radius 
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Just as with PLOT and DRAW, you can pul the various sorts of colour items in at the beginning of a 
CIRCLE statement 

The POINT function tells you whether a pixel is ink or paper colour Its two arguments are the 
coordinates of the pixel (which must be enclosed in brackets) and its result is 0 if the pixel is paper 
colour, or 1 if it is ink colour Try. 

CLS : PRINT POINT (0,0): PLOT 0, 

0: PRINT POINT (0,0) 

Type 

PAPER 7: INK 0 

and investigate how INVERSE and OVER work inside a P L 0 T statement. These two affect just 
the relevant pixel, and not the rest of the character cell, They are normally off (0) m a PLOT 
statement, so you only need to mention them to turn them on (1), 

Here is a list of the possibilities for reference, 

PLOT; This is the usual form. It plots an ink dot, re, sets the 

pixel to show the rnk colour 

PLOT INVERSE 1; • This plots a dot of ink eradicator', le. it sets the pixel to 

show the paper colour 

PLOT OVER 1; -This exchanges the pixel colour with whatever it was 

before, so if it was ink colour then it becomes paper 
colour, and vice versa 

PLOT INVERSE 1; OVER 1; -This leaves the pixel exactly as it was before, but note 

that it also changes the P LOT position, so you might 
use it simply to do that 

As another example of using the 0 V E R statement, fill the screen up with writing using black on white, 
and then type 

PLOT 0,0: DRAW OVER 1;255,175 

This will draw a fairly decent line even though it has gaps m it wherever it hits some writing Now type 
in exactly the same command again. The line will vanish without leaving any trace whatsoever - this is 
the great advantage of 0 V E R 1 If you had drawn the line using. 

PLOT 0,0: DRAW 255,175 

...and erased it using 

PLOT 0,0: DRAW INVERSE 1;255,175 

, then you would also have erased some of the writing. 
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Now try. 

PLOT 0,0: DRAW OVER 1;250,175 

. .and try to'undraw it using... 

DRAW OVER 1;-250,-175 

This doesn't quite work because the pixels that the line uses on the way back are not quite the same as 
the ones that it used on the way there You must therefore undraw a line in exactly the same direction 
as you drew it. 

One way to get unusual colours is to speckle two normal ones together in a single square, using a 
user-defined graphic Try this program. 


1000 

FOR n=0 

TO 6 

STEP 2 



1010 

POKE US R 

"a" + 

n, BIN 

01010 

10 


1: POKE 

USR " 

'a"+n+1 

, BIN 

10 


101010 





1020 

NEXT n 





1030 

REM now 

press 

GRAPH 

then 

A 


which gives the user-defined graphic corresponding to a chessboard pattern. If you print this 
character (press GRAPH, then A) you will find that the character is reproduced in a combination of 
the current paper and ink colours. 

Exercises. 

1 Experiment with PAPER INK. FLASH and BRIGHT items m a PLOT statement These are 
the parts that affect the whole of the character cell containing the pixel Normally it is as though the 
PLOT statement had started off 

PLOT PAPER 8; FLASH 8; BRIGHT 8; etc 

,, and only the ink colour of a character cel! is altered when something is plotted there, dut you can 
change this if you wish 

Be especially careful when using colours withINVERSE 1, because this sets the pixel to show the 
paper colour, and may change the ink colour, which might not be what you expect 


2. If you have read part 10, see if you can work out how to draw circles using SIN and COS Run this 
program 


10 FOR n=0 TO 2* PI STEP PI /I 
80 

20 PLOT 100+80* COS n, 87+80* 
SIN n 
30 NEXT n 

40 CIRCLE 150, 87, 80 


You can see that the CIR C L E statement is much quicker, albeit less accurate. 
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3. Try.. 


CIRCLE 100,87,80: DRAW 50,50 


You can see from this that the CIRCLE statement leaves the PLOT position at a rather 
indeterminate place - it is always somewhere about half way up the right-hand side of the circle. You 
will usually need to follow the CIRCLE statement with a P LO T statement before you do any more 
drawing. 
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Part 18 
Timing 

Subjects covered... 

PAUSE,PEEK,INKEYS 

Quite often you will want to make the program take a specified length of time, and for this you will find 
the P A U S E statement useful 

PAUSE n 

stops computing and displays the picture for n frames of the TV (there are 50 frames per second in 
Europe and 60 in USA), The value of n can be up to 65535, which gives you a pause of just under 22 
minutes If n=0 then it means pause indefinitely' 

A pause can always De cut short by pressing a key. 

This program works the second hand of a clock 


10 

REM 

first w 

e draw 

the 

c L 

ock 


f a c 

e 





20 

FOR 

n= 1 TO 

12 




30 

PRINT AT 10 

-10* COS (n 

/ 6 

* P 


I >y 

16+10* 

SIN (n 

/6* P 

1 

); n 

40 

NEXT 

n 





50 

REM 

now we 

start 

the c 

to 

c k 

60 

FOR 

t = 0 TO 

200000 

: REM 

t 

i s 


the 

time i 

n seco 

nds 



70 

LET 

a=t/30* 

PI : 

REM a 

i 

s t 


he a 

ngle of 

the s 

econd 

h 

and 


i n 

radians 





80 

LET 

sx = 80* 

SIN a: 

LET 

sy 

= 80 


* COS a 





200 

PLOT 

128,88 

: DRAW 

OVER 

1 

; sx 


zsy: 

REM dr 

aw sec 

ond h 

an 

d 

210 

PAUS 

E 42 





220 

PLOT 

128,88 

: DRAW 

OVER 

1 

; s x 


,sy: 

REM er 

ase se 

cond 

ha 

nd 

400 

NEXT 

t 






The clock will run down after about 55,5 horns because of line 60, but you can easily make il mi 
longer. Note how the timing is controlled by line 210 You might expect PAUSE 50 to make it nek 
once per second, however, the compunng takes a bit of time as well and has to be allowed lor. This is 
best done by trial and error, timing the +3 clock against a real one and adjusting line 210 until they 
agree You can t do this very accurately - an adjustment ol one name per second is equal to 2% (or half 
an hour m a clay) 
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There is a much more accurate way of measuring time. 'This uses the contents of certain memory 
locations. The data stored is retrieved by using P E E K. Part 25 of this chapter explains what we re 
looking at in detail. Type in the expression... 


PRINT (65536* PEEK 23674+256* PE 
EK 23673+ PEEK 23672)750 


This prints the number of seconds since the +3 was tut ned on (up to about 3daysand21 hours after 
which it goes back to 0) 

Here is a revised clock program to make use of this,. 

10 REM first we draw the clock 
face 

20 FOR n=1 TO 12 

30 PRINT AT 10-10* COS (n/6* P 
I 5,16+10* SIN (n/6* PI );n 

40 NEXT n 

50 DEF FN t()= INT ((65536* PE 
EK 23674+256* PEEK 23673+ P 
EEK 23672)/50): REM number 
of seconds since start 

100 REM now we start the clock 

110 LET t1= FN tO 

120 LET a=t1/30* PI: REM a is t 
he angle of the second hand 
in radians 

130 LET sx=72* SIN a: LET sy = 72 
* COS a 

140 PLOT 131,91: DRAW OVER 1;sx 
,sy: REM draw hand 
200 LET t= FN t() 

210 IF t< = 11 THEN GO TO 200: RE 
M will wait until time for 
next hand 

220 PLOT 131,91: DRAW OVER 1;sx 
,sy: REM rub out old hand 
230 LET 11 = t: GO TO 120 

The internal dock that this method uses should be accurate to about 0.01% (approx 10 seconds per 
day) so long as the +3 is simply running the program. However, when you use the B E E P statement 
(described m pan 19 of this chapter) or operate the disk drive or any peripheral ttached to the +3 
(eg a pnnter or second disk drive), the internal dock stops temporary, losing time. 
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The numbers PEEK 23674. PEEK 23673 and PEEK 23672 are held inside the + 

3 and used for counting in 50ths of a second. Each is between 0 and 255 and they gradually increase 
through all the numbers from 0 to 255, after 255 they drop straight back to 0. 

The one that increases most often isPEEK 23672 - every i/50 second it increases by 1 When it is 
at 255. the next increase 'nudges’ it to 0, and at the same time it increments PEEK 23673 up by 1 
When (every 256/50 seconds) PEEK 23673 is nudged tom 255 to 0, it in turn increments 
PEEK 23674 up by i This should be enough to explain why the expression above works. 

Now, consider this carefully: suppose our three numbers are 0 (for P E E K 2 3 6 7 4), 255 (for PEEK 
23673) and 285 (for PEEK 23672). This means that it tsabout2! minutes after switch on Our 
expression ouqht to yield (65536x0+256x258+2S5)/50 which is equal to 1310.7 

But there is a hidden danger - the next time there is a 1/50 second count, the three numbers will 
change to 1,0 and 0. Every so often, this will happen when you are half way through evaluating the 
expression the +3 would evaluate PEEK 23674 as 0, but then change the other two to 0 before 
it can PEEK then:. The answer would then be (65536x0+ 256x0+0)/50 which is ecfual to 0 which is 
obviously wrong, 

A simple way of avoiding this problem is to evaluate the expression twice m succession and take the 
larger answer 

Now if you look carefully at the previous program, you canseethatitdoesthis implicitly. 

Here tsa trick to apply the rule Define the functions . 


10 

DEF FN 

m (x, 

y)=(x+y+ ABS 

(x- 


y>)/2: 

REM 

the Larger of 

X 


and y 




20 

DEF FN 

u() = 

(65536* PEEK 

236 


74+256* 

PEEK 23673+ PEEK 

23 


672)/50 

: REM time (may b 

e w 


rong) 




30 

DEF FN 

t(> = 

FN m( FN u() 

, F 


N u()) : 

REM 

time (correc 

t) 


You can change the three counter numbers so that they give the real time instead of the time since the 
+3 was switched on, For instance, to set the time at 10.00am, you work out that this is 10 x 60 x 60 x 50 
which is equal to 1800000 fiftieths of a second (and 1800000 is equal to 65536 x 37 + 256 x 119 + 64x 1) 

To set the three numbers to 27 119 and 64 you type 

POKE 23674,27: POKE 23673,119: POKE 23672,64 

In countries with mams frequencies of 60 Hz (cycles per second), these programs must replace 50 by 
60 where appropriate 
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The function IN K E Y $ (which has no argument) reaas the keyboard If you are pressing just one key, 
(or say CAPS SHIFT and just one other key), then the result is the character which that key gives 
normally, otherwise the result is an empty string 

TTy this program, which works like a typewriter 

10 IF INKEYS <> "" THEN GO TO 
10 

20 IF INKEYS ="" THEN GO TO 20 
30 PRINT INKEYS ; 

40 GO TO 10 

Here line 10 waits for you to lift your finger off the keyboard, and line 20 waits for you to press a new 
key. 

Unlike INPUT, INKEYS doesn't wait for you. so you don't have to press ENTER 
Exercises, 

1, What happens ifyou miss out line 10 in the typewriter'program? 

2. Another way of using IN K E Y $ is in conjunction with PAUSE as in this alternative typewriter 
program... 

10 PAUSE 0 
20 PRINT INKEYS ; 

30 GO TO 10 

To make this work, why is it essential that a pause should not finish if it finds you already pressing a key 
when it starts? 


3 Adapt the •• v seccng hang ; rngratn s> that it ,i.s: shows minute and hem tec as redrawing 
them -ven tranuie I: v ure feeling ambitious arra"!* sj that every quarter ol an hour it puts an 
i - -:ncJ fshow '-mh:-i ■ y>:. .uldr.r.-duce Hie Bio Iv: ’him- i.sir.:. PLAY i--.'!:i»• o mpart 
V f this -TlnplCt 1 
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Part 19 
Sound 

Subjects covered... 

BEEP,PLAY 

As you will have already noticed, the +3 can make a variety of noises To get the best quality of 
sound it's important to make sure that your TV is tuned-m properly (see chapter 2). If. instead of a TV, 
you are using a VDU monitor (whidi won t reproduce the +5 s sound), note thal a separate sound 
signal (which may be connected to an audio amplifier powering speaker(s) or headphones) is 
available from the TAPE/SOUND racket at the back the +3 Headphones may not be plugged int 
the TAPE/SOUND socket directly 

Connections to th^ TAPE/SOUND socket are described in chapter! 0 

To get the most out of the -1-3 s musical ability, it helps to have a little knowledge about musical terms 

Note that in the examples that follow, it is important that you type m the string expressions exactly as 
shown in upper case and lower case letters, te the example " g a " should not be typed in as " G a " 

"gA"or''GA" 

Type in this command (don't worry about what it means just yet) 

PLAY "ga" 

Two notes were played the second slightly higher than the first The difference between the notes is 
called a tone Now'ry 

PLAY "g$a" 

Again there were two notes played - the first one was the same as the previous example but there we; 
less of a jump to the second. If you didn't hear the difference then try the first example followed by the 
second again. The second example has half the difference between notes ana this is called a 

semitone 

When you re happy with semitones try tins 

PLAY "gD" 

This sort of difference is called a fifth and occurs quite :Hen in music of all kinds With that example 
ringing in yout ears, type 

PLAY "gG" 
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Although t hopefully) you noticed that there was a much bigger difference that time than for the fifth, 
the two notes somehow sounded much more similar. This is called an octave and is the point at which 
music sta rts to repeat itself. Don t worry about that unduly, just remember what an octave sounds like 

Thei e ate two ways of making music and sounds with the +3 The most elementary is the somewhat 
spartan BEEP command This takes the form 

BEE P duration, pitch 

where the duration and pitch parameters represent nunrerical expressions The duration is given m 
seconds and the pitch is given in semitones above middle C (negative numbers for notes below 
middle C) 

Here is a diagram to show the pitch valuesofall the notes m one octave or, the piano for B E E P 



Hence, to piay the A above middle C for half a second, you would use 

BEEP 0.5,9 

and to play a scale (lot example C major) a complete (albeit short) program is needed 

10 FOR f=1 TO 8 
20 READ note 
30 BEEP 0.5,note 
40 NEXT f 

50 DATA 0,2,4,5,7,9,11,12 

jet higher oriowet notes, you have toada or subtract 12 for each octave that you go up or down 

BEEP exists mostly tc provide compatibility with the older designs of Spectrum, though it car, be 
useful for very short or rapid sound effects For any new programs you develop, the second way of 
producing sound is much to be preferred nrd this is achieved using the PLAY command (if you 
worked through the simple examples earlier in this section, you :, remember that thsts what you 
used) 
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P L A Y is much more flexible than BEEP it can play up to three voices m harmony with all manner of 
effects, and gives much higher quality of sound. It's also much easier to use For example, to play A 
above middle C for half a second, simply type in.,, 

PLAY "a" 

and to play the C major scale (which needed a program to itself before), use 

PLAY "cdefgabC" 

Notice that the last C in the example above is m upper case This tells the P L A Y command to play it 
an octave higher than the lower case c A scale, by the way, is the term used for a set of notes 
spanning an octave. The example above is called the C major scale because it's the set of notes 
between two C's Why major 9 There are two main classes of scale, major and minor, and this is just 
musical shorthand for describing two different sets Just for interest, the C minor scale sounds like 
this 


PLAY "cd$efg$a$bC" 

Preceding a note by $ drops it by a semitone ( flattens it) and preceding a note by tf raises it by • 
semitone ( sharpens it) The PLAY command spans 9 octaves, and can be told which one to use by 
having the upper case letter 0 followed by a number m the list of notes it is given, Type ir. this little 
program 

10 LET o$="05" 

20 LET n$="DECcg" 

30 LET a$=o$+n$ 

40 PLAY a$ 

There are ? few new things in this program f irstly PLAY is just as happy with a string variable as 
with a string constant. In other words, providing that a$ has beer, set up beforehand PLAY a$ 
works rust as well as PLAY "05 DEC eg" In fact, using variables m PLAY statements has 
certain distinct advantages and we shall be doing this from new cm 

Notice also that the string a$ has been built up by combining the two smaller strings o$ and n$ 
While this doesnt make much difference at this sort of level PLAY can cope with strings many 
thousands of notes long, and the only sensible way of creating and editing those strings from BASIC is 
to combine lots of smaller strings m this way 

Now tun the above program Edit line :0 so that "05" becomes " 07 " and run it again or if you 
want to be a big spaceship make it " 0 2 " It you don t specify an octave number for a particular 
string, then the +3 assumes that you want octave 5 Here follows a diagram of the notes and octave 
numbers which correspond to the standard even-tempered musicalscale 
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There isa lot of overlap, so for example "03D" is the same as "04d" This makes il easier to write 
tunes without having to change octave all the time. Some of the notes in the lowest octaves (0 and I) 
aren't very accurate for technical reasons, and so the computer just makes a brave attempt at getting 
as close as possible. 

PLAY can also handle many different lengths of note Edit the program above so that line 10 is now 

10 LET o$="2" 

and run it Then alter the setting of o$ between " 1 " and "9" The note length can be changed 
anywhere in a string by including a number between i and 9, and this is effective for all subsequent 
notes until a new number is encountered. Each of these nine note lengths has a spenfic musical name, 
and looks different when written down in musical notation. The following table shows which is which. 
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NUMBER 

NOTE NAME 

MUSICAL SYMBOL 

1 

semi-quaver 

} 

2 

dotted semi-quaver 

/ 

3 

quaver 

; 

4 

dotted quaver 


S 

crotchet 

j 

6 

dotted crotchet 

j. 

7 

minim 

j 

8 

dotted minim 

i 

9 

semi-breve 

o 


PLAY .ar. -isc -ope with triplets which are three notes played m the lime for two Unlike simple 
note lengths the triplet number only applies for the three notes immediately following, and then the 
previous note length number resumes. The triplet numbers are as follows. 


NUMBER 

NOTE NAME 

MUSICAL SYMBOL 

10 

triplet semi quaver 


11 

triplet quaver 

JT .I 

12 

triplet crotchet 

r~ 3 

JJJ 


PLAY sqtflH y 1 1 ut being told to shut jp • A Tinea perio -i J;n mg which no notes play is edited 
i i' si n.ii'v this The length of rest it produces is the same as the current note 

length To demonstrate edit fines l r 'ar.a 20 1 : 

10 LET o$="04" 

20 LET n$="DECScg" 

■ - ignifi i in a PLAY 
5 7c" (The 

second value is then used as the note length for all subsequent notes as before 

There are occasions when ambiguity creeps m S3y that a piece of music needs : stave 6 and a not- 
length of 2 then 

10 LET o$="062" 
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seems - gcoo bei but no The computer will find the 0 and try to read tne number following 11 
Win • it 'mbs 62 it will stop with the report n Out of range In cases like this, there is a 
rummy m t called N that )ust serves to split things up. solme iOshouldbc 

10 LET o$="06N2" 

Hi- 1 ir - can be set between 0 (minimum.) and 15 (maximum)using "V 11 followed by a number In 
■ ■ reh fill, as 1 to 9 are I ft inless tfts +3 is being usei 1 1 

Asprsv yi : BEEP: . : . nne i of PLAY. if all On 

■ ■ 15. then it should be at the sam6 level as a note produced by B E E P 

Playing more than one channel at a lime is very simple, you just separate lists ot notes by commas Try 

this now program 

10 LET a$ = "04 c Cc CgGgG" 

20 LET b$="06CaCe$bd$bD" 

30 PLAY a$,b$ 

In general, there is no lilf -fence between the three channels, and any string of notes can be put onto 
any channel The o. - mil speed of the music (the- tempo) must be in the string assiqned to channel A 
(the first string •' r PLAY otherwise it will be ignored 1' set tempo in bents (crotchets)per 
mit.utt-, use "T" followed by ■. number between 60 and 24' The standard value is .20, or two 
-rotchetsper sec no Modify the program above to 

5 LET t$="T120" 

10 LET a$=t$+"04cCcCgGgG" 

20 LET b$="06CaCe$bd$bD" 

30 PLAY a$,b$ 

ind run il several limes, changing line 5 tor different »• rapes 

A "t turnon tc.uurr n music is the re petition of a group of notes Any part of a string can be repealed by 
enclosin'i mil brackets uy uchangelme 10 to 

10 LET a$=t$+"04(cC)(gG)" 

PLAY': • ilosing bracket (with no matching 

rung bracket 'he • the string up to that point is repealed indefinitely This is useful for rhythm 

BREAK 

PLAY "04N2cdefgfed)" 


ard 

PLAY "04N2cd(efgf)ed)" 
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If you set up an infinitely repeating bass line, and then play a melody with it then it would be nice if the 
bass line stops when the melody does. There is a device to do this - if P L A Y comes across "H" (for 
halt) in any of (he strings it is playing, then it stops all sound immediately Run the following program 
(again, you'll have to press BREAK to stop it) 

10 LET a$="cegbdfaC" 

20 LET b$="04cC)" 

30 PLAY a$,bS 

Now modify line 10 to. 

10 LET a$="cegbdfaCH" 

and run it again 

So far we've only used notes which start and stop at one level of volume. The +3 can alter the volume 
of a note while it is playing, so it can start loud and die away like a piano, or rise and fall like a dog 
growling To turn these effects on use " W " (for wavefoTm) followed by a number between 0 and 7, 
together with " 1)" for each channel you want to use the effect on. Any channel with a volume setting 
("V") will not respond to "U" This table shows graphically how the volume changes for each 
setting. 



i|4_ 

2N- 

3/ 

4\J\N\KN n 

5 A4A4/W 


6 



O-smgledecaythenoft 

1 ^single attack then off 

2 - single decay then hold 

3 - single attack then hold 

4 repeated decay 
5-repeated attack 

5 - repeated attack-decay 
7 - repeated decay-attack 


7 



This program plays the same note with each effect tn turn so you can c . rr.pare them against the 
diagram above 


10 LET a$="UX1000W0C&WlC&W2C&W 
3C&W4C&W5C&W6CSW7C" 

20 PLAY a$ 
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The U turns on effects, and the W selects which waveform to use. There's also an " X10 0 0 " X sets 
hi >w long the effect will last for (from 0 to 65535). If you don't include an X then the +3 will choose the 
longest value Wavefotms that settle down (0 to 3 in the previous table) after the initial part, work best 
with X settings of about 1000. whereas repetitive effects (4-7) are more effective with short values like 
300 Try varying the X setting in the previous program to get some idea of how each works. 

The PLAY command isn't limited to pure musical notes There are also three white noise 1 generators 
(white noise is a sound which ts like an un-tuned FM radio or TV), and any of the f hree channels can 
t lay : otes. while noise, ot a mixture of both To select a mix of noise and note you may use " M " 
followed byanumber between 1 and 63. You can work out which number to use from this table 



Tone channels 

Noise channels | 

A 

B 

C 

A 

B 

C 

Numbor 


2 

4 

8 

16 

32 


Write down the numbers corresponding to the effects you want, and then add them toqethet. If you 
wanted A to be noise B to b tone, and C to be both tone and noise then add 8,2.4 and 32 to get 46 (th> 
order of the channels is the older of the strings which follow the P L A Y command). The best effects 
can be obtained with the A channel - don t be afraid to experiment 

By now you'll be writing symphonies' However, it can be difficult to work out just which part of the 
music a particular section of siring is responsible for To alleviate this: problem, youi music stung may 
include comments'enclosed between ! exclamation marks for example 

1090 LET z $ = "C Dc E 3GeA_6f! end of 
75th bar !egeA" 

Hi PLAY command wil. simply hop ov' i my comments m the strum 

nt with Mil 1,1 -3 - PLAY Up to 

; tto ■ tsequence! PLAY ■ 

is constructed exactly a? described so lat in this section except that each string should include a 
11 v "followed 1 ' ' ' ' ■ : : ■ • Y ■ tit) ihstll 

music data is assigned to. Up to eight strings can bo used the first three strings will sbi bt played 
tin. uxjh the I'V as before so you'll pt> bnbly wont to turn the TV sound down. You can ,»l- send MIDI 
pro urn t i ' PLAY " Z" j ■ 1 by i< imber fftry 

i s)art al alafed aid nt 18hm tl Vsettn "V6" r t$$asnkey 

velocity) 
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So to send a little tune (in four-part harmony; to a four voice synthesiser fatter consulting your synth 
handbook to find - ut how to allocate MIDI channels to different voices), you would use the PLAY 
command with . ur stimgs, each starting with Y followed by a number This example program 
illustrates the P L A Y command in some of its full glory 

10 LET a$="Y1T100O2(((1CCg$b)) 

(($E$E$b$D))C(FFCSE))((GGDF 
))))" 

20 LET b$="Y205N8888C$bfG)" 

30 LET c$="Y304((3C8)C81CCDD(3 
$ES)$ES1$ESEEE<3F&)FS1FFSGS 
G(3G8)G81GG$EC ))" 

40 LET d$="Y4N988888888(9EGF7b 
5 C D) ) " 

50 PLAY a$,b$,c$,d$ 

Summary table 


Fmally, here is a brief list of the parameters that can be used in the strma r.f a PLAY cotnmanc 
together with the values they may take 


STRING 

FUNCTION 

a g 1 

A G 

Specifies the pitch of the note within the current octave range 

S 

Specifies that the note which follows must be flattened 

# 

Specifies that the note which follows must be sharpened 

0 

Specifies the octave n umber to be used (followed by 0 to 8) 

1 12 

Specifies the length of notes tc be used 

& 

Specifies that a rest is to be playea, 

- 

Specifies that a tied note is to be played. 

N 

Separates two numbers 

V 

Specifies the volume to be used (followed by Oto 15) 

U 

Specifies the volume effect to be used (followed by 0 to i i 

u 

Specifies that the volume effect is to be used in a string 

X 

Specifies duration of volume effect (followed by !1 to 65535) 

T 

Specifies tempo of music (followed by 60 to 240) 

() 

Specifies that enclosed phrase must be repeated 


Specifies that enclosed comment is to be skipped : vet 

H 

Specifies that the PLAY : 

M 

Specifiesihechannel(s)tobeused (followed by : to63i 

Y 

Specifies that MIDI channel Islo be used (followed by ito 15) 

Z 

Specifies MIDI programming code (followed by code number) 


142 




Part 20 

File operations 

Subjects covered... 

Drives 

FORMAT 

Filenames 

SAVE, LOAD 

Disk catalog: CAT 

Wildcards 

MERGE 

Deleting and renaming files 

File attributes 

ERASE,MOVE, COPY 

TheRAMdisk 

Tape operations 

VERIFY 

Tape catalog: CAT 

Drives 

The +3 has a built in disk drive that can be used to save and load your own programs, ana to load 
programs produced by other people. As it is also possible to connect a second disk drive to the +3 
BASIC must have some way of idennfytng which disk drive is which The built-in drive is known as 
otiveA. (always followed by a colon because +3 BASIC throws that when you say A. you mean disk 
drive A j If the external drive is present it is referred to as drive B 

A- the processor at the heart of the +3 can only converse with 64K I men vy at a time the extra 
RAM ir. the +3 s 128K rr.> -tory is used just like another drive. Tins is called the RAMdisk and is 
identified by the letter M i f n memory drive) AT the commands (except FORMAT) that you can use 
on drives A ana B can also be used on drive M Drive M. is much faster than the mechanical disk¬ 
drives, but it is very important to remember that just like the contents of the piogtam memory the the 
contents of dnve M. are erased it you press the RESET button or switch of! the +3 BASIC's NEW 
command, however will leave any hies stored on drive M. intact 


Ir you don 1 have a second diskdrive connected to ycut +3 you can still use the machine as if drive r 
were present II you ask the machine to perform an operanon on drive B (you’ll see how to do this 
i.iter), a message wilt appear asking you to. 

Please put the disk for B: into 
the drive then press any key 
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whereupon you should put the disk that you would have used in drive B (if it had existed) into drive 
A then piess an key (for example ENTER From the:, or the machine will treat the built-in disk 
drive as if it really were drive B When the +3 next needs tc perform some operation on the disk that 
was originally in the drive, if will ask you to. 

Please put the disk for A: into 
the drive then press any key 

This technique will be particularly useful when using the CO P Y command (described later m this 
section). 

Now that you know which drives are available and what they are called, let's see what they can be 
used for Type in the short program (which displays coloured squares) that you hist met at the end of 
par! 16, le. 

10 POKE 22527+ RND *704, RND * 

127 

20 GO TO 10 

This is the program that you are going to save onto disk 

As previously explained (in chapter 6), you cannot simply unwrap a brand new disk and hope tc save 
programs onto it straight away, n must fust be made ready to use with the aid of the FORMAT 
command FORMAT will erase anything that was previously on the disk and set it up for +3 BASIC 
touse. Be careful, therefore not to FORMAT any disk that has programs on it you might like to keep 
To format your new disk rype m the following 

FORMAT "a:" 

If you haven't already put your new disk into the drive don t worry - the +3 will ust come back with 
iheerrorreport D r i ve not ready 

In this case put your new disk into drive A and re-type the command 

By the way while you aie using the variu.is disk commands you may occasionally see the report 
Drive A: not ready ; y wed by - Retry, Ignore or 

Cance l ?, This invariably means that you liave forgolten to put a disk mto the drive 

Whenever a report appears that ends with - Retry, Ignore or Cancel ? there 
are three options open to you 

The first is lo take iction tc tecttfy the problem, for example if the retpon was Drive not 
ready, then put u disk into the drive and type R (to retry) The disk system wifi then try tc carry; jt 
the same operation again and hopefully this time it will succeed 

If y< iu were has way through copying a iarge file and an error such as Missing address 
mark appeared, this would usually mean that the disk being read has beer, damaged m some way 
fry R a few times and if Ihe c-rror persists, you indeed have a damaged disk At this stagy you, 
probably want to salvage any un damaged data so try typing I to ignore) Although this tells the 
+3 s disk system to ignore the error there is no guarantee that all your data will bo read ml ct ii 
really just a last ditch operation when all else has failed 


144 


finally, if you have tried to perform an operation where an error occurs, you may realise that there is 
no point m trying to go on. In this case type C (to cancel) which tells the +3 s disk system to abandon 
the current command. Having typed C BASIC will report an error (usually very similar to the text of 
the previous report). 

Back to our attempt to format a disk. If you have made a mistake and the disk you put into drive A, has 
already been formatted, the +3 will spot thrsar d you will receive the report 

Disk is already formatted, 

A to abandon, other key continue 

This is a saiety feature that will allow you to abandon the format before the process gets going, if, by 
some chance, you inserted the wrong disk In tins case you should type A (to abandon i and nothing 
more will happen If however you really do intend to reformat the disk and don't mind losing what son 
it, then press any key apart from A (eg press ENTER 

Auer about 30 seconds, the usual 0 OK repott will appeal The disk is now usable and should not 
need to be formatted again. You can aiways reformat a disk if you wish to dear the disk of data 
completely, but remember that it is an irreversible process. 

Disks can occasionally become spoil’ corrupted') i his can happen if some oust oi dirt o mes into 
contact with the disk surface, if the disk is left too close to a magneto: field (such as that produced by a 
TV or a telephone), if the disk is elected while it is being written to, or if the disk is 'eft in the drive 
when the computer is switched oner off A corrupted disk will cause errors dunng LOAD or SAVE 
and shouid be reformatted before any more data is saved onto it 

If you want to recover flies from a corrupted disk, you can try to copy them individually (using COPY) 
to a known good disk. If one or more flies prove ur.copiable then you have probably lost them for 
good We recommend that you keep at least two copies of important files (on different disks) - one for 
day-to-day use, and one kept m a safe place tust in case the unthinkable happens Making regular 
copies of valuable data and programs is known as backmg-up and is an essential habit t< gel mt< 
Backing-up can save you untold misery and tears Ye a can of course make back-ups onto tape which 
may prove cheaper in the long run 

Unlike many computers the F 0 R M A T unmand is built-in and can be used like any other BASIC 
command It doesn't affect the program you have ir. the computer sc you car. now save the littie 
two-lme program you typed in a momeni ago 

Type m the following 

SAVE "squares" 

The word SQUARES is past a name that you v label the program you are going rc store or disk 
To prevent rcrvfusior. everything stored or. disk must be giver, a name These names (called 
filenames are a littie different from those that you may use when storing programs on tape. 
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Filenames 


The range of characters that you are allowed to use for disk filenames is more limited than for tape 
filenames The format of filenames used on +3 disks is the same as that used by an operating system 
known as CP M (Control PToqram.'Monitor) by Digital Research Inc The fact that these formats are the 
same means that you cart take a +3 disk and use it on other computers. Data can be transferred in 
this way between the +3 and a CP'M system, and this is most likely to be useful for people writing 
machine code programs or moving text from a +3 word processor to a CP M program (It ts 
extremely unlikely that programs written in BASIC can be usefully converted from one machine to 
another using this method ) 

Filenames can be as simple as the example above S Q U A R E S (or even simpler ■ S. for example). 
However a full CP ; M-type filename can be made up of as many as four parts user number drive letter 
name and type Each of these parts is called a field (eg the name field or the type field) 

You needn't worry about what user number means; if you don’t know already, then it sprobably best to 
remain blissfully ignorant However, for anyone who is interested, on CP/M machines with very large 
disk capacities (or hard disxs) with perhaps more than one terminal connected, user numbeis are 
used to partition files into subsections f known as user areas) so 'hat there isn't just one huge directory 
with several thousand files On the +3 however disks cannot have more than 64 files so the use ol 
user areas is not really necessary. Nevertheless user areas can be specified in filenames used in +3 
disk commands They ta ke the iorm 

user number drive letter : filename 

whete user number is in the range 0 to ,5 and drive letter is A B or M. If you specify a user 
number, then you must a iso specify a drive letter So, to save our example program m user area 5. we 
would use 

SAVE "5a:squares" 

The problem with using user areas is that it s quite easy to forcret which user uiea you saved a file to, 
■tna sc finding it could take a whiie (as ihc- CAT commune can ca'-uicg ■; ne user y ea at a time.) 

As just mentioned i):o drive «et»-r will normally be A. b •: M Notice that the iettei must be followed 
byaootoi ) a: squares, :;v . I n'l ;■ ■ dr» - letter (hen +3 BASIC thednV^ 

that was last -jsea this is k:. •.*.*. >; the default dnv- (When yuu first switch on the +3 the default 
drive is set tc A ) So typing 

SAVE M SQU3r6S M 

is last ss if you had typeo 

SAVE "atsquares" 
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There ai- specia. forms of SAVE and LOAD which can be used to change the default drive When 
SAVE > LOAD is followed by a filename that l Invelettei 

drive identified by the letter isthen made the new default dnv- r Sri 

SAVE "m:" 

SAVE "squares" 


will change the default drive m drive M then save tile program onto drive M (It the abr :• 
been SAVE "n:squa res", the pi ram would still ha 
though the default drive would not have been changed.) 

To switch the default back to drive A type 

SAVE "a:" 


hat SAVE and LOAD foilowi Invi tlei 

change the default drr. • They certainly won't it ve< i load : program Yc u must use SAVE i LOAD 
followed by a real filename for this 

SAVE LOAD etc 

The name field can be from i to 8 characters long and may contain any ol the following 


Letter.- abcdef ghi j k Imnopqrstuvwxyz {upperei lowercase 

Dions 01234 5 6789 

Othef characters "#$'3 


'J; o i . .d ,..w> i : .rrtei:-are the same in :ii"....i' es EXAMPLE l example wo'ij'l b* 
identical. 

A filename can end with at. optional type field (which is mst a further three characters) that you may 
wish to use in bidet fo group together files of the same type If a type field is specified it must bo 
preceded by a dot (Unlike some tithe i BASICs. +3 BASIC does not automatically allocate -j type 
held tc files if one is not specified, i You may find it useful to add your own type fields • a popular 

. .BAS- BAS] fill nd .BINl ideitify code fill 

BIN i • r !• •• ! f, ' i think this is a good idee then (he previous example program 
could be saved iimng 


SAVE "squares.bas" 

lets * And ? • 3 not I 

LOAD and SAVE Them * 17 canbt 

Iy ii'-:c,islltuei 
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Here are some examplesof valid filenames - 


z 

squares 
m: pi c ture.bin 
a:f red 
13a:he l lo 
0M:CAPITALS 
test.bas 
phi Lip 
glass.mus 
a : a . a 

Here are some illegal filenames (and reasons why).,. 

p a c man (must not contain any spaces) 

(test) (must not contain brackets) 

/<>-+=! S (.must not contain any oithese characters) 

excessive (more than 8 characters long) 

.bas (has no name field) 

later... (only one dot allowed) 

7 : d u b i o u s (if user number is specified, then filename must also contain drive 

letter-eg. 7a: dubi ous 

Disk catalog 

You may have spotted the fact that we have now saved the sane program twice with two different 
names (SQUARES and SQUARES.BAS) It v: utd be nice to be able to check what has been 
saved v.na particular disk, and this is where the CAT command comes in CAT displays a catalog of 
what you have stored on a disk 

Press ENTER then type in 


The +3 will take := quick look at the disk (the read write indicate! lumpwil.. .me on briefly) and wilt 
display a list of the disk's contents on the screen The list is sorted imo alphanumerical order and each 
tile is followed by an indication of tissue to the nearest number of kilobytes (rounded up i At the end 
ortho list the amount of free space on the disk is also -displayed 

CAT ■ :i it:-, awn) is tli simplest form •- the xmr and I: v: u wanted tc s?t1 the dies . - a different 
drive (eg drive M ) you would use 

CAT "m:" 
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When C A T is followed by a filename containing ;ust a dnve letter, le A: B: or M: (including the 
colon), all the files on the nominated drive will be listed C A T on its own gave a list of the files on drive 
A this is because A is the current default drive You will Temember that LOAD or SAVE followed 
by a dnve letter will make that drive the cur rent default. So.. 

LOAD "m:" 

CAT 

will also list all the files on dnve M. This isn't quite the -same as C A T " m : ", because now the 
default drive has been left as M. Change it back to A before going further 

We will now save several copies of our simple example program using different names, so that you 
will be able to see what the various forms of the CAT command will produce. So far the disk should 
contain SQUARES and SQUARES.BAS If either of these weren t listed with the above CAT 
command, add their name to the list below. Type the following. 

SAVE "fred" 

SAVE "fat" 

SAVE "santa.bin" 

SAVE "trepur.bak" 

SAVE "cliff.cjl" 

SAVE "sausages. bas" 

Don't worry about cluttering up the disk with lots of copies of the same thing - you'll be shown how files 
can be erased later. 


Wildcards 

lfa disk hasa large number of files, it is often desirable to selectively lisi nly those of interest The +3 
. nets tot 'his If, for example you wished to list only those files that ended m .BAS you would use 

CAT "*.bas" 

The rix character * s what known a midcard When a filename, perhaps containing a 
Wirt' m, is specified. CAT will list only the files that match the specification given When the * 
v/u'i - m is used (in either the name field or the type field) it means 'any character from here to the 
. i : this field S. lntheabu ;e uomir.md .we want C AT to display any files that have any characters 
mill i :-.ime field and the IctetsBAS in their type field If there are no files on the disk that match the 
sp ■: nion. the report No files found will be displayed (followed by the amount of free 
sp- ic j If yo j give a file specification of *. * (le CAT "*.*") or no specification at all be CAT) 
and 'he report No files foundis displayed then this means that the disk is empty Ar. 
empty disk in drive A crB will have a free space value of 17 3K (this value may be different tor disks 
Iron, .other types of computer, Ar. empty drive M will usually have 58K free If you catalog a disk 
containing a commercial program (such as a game) U might appear to have no fiies on it but very little 
space free This is a protection measure taken by the software writers to prevent illicit copying and 
shouidn l cause any concern 
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If we use. 

CAT "s*.bas" 

then a)! files that begin with the letter S and then have any characters whatsoever between the S 
and the end of the name field, followed by a type field of B A S will be shown Files with the names 

SQUARES.BAS SAUSAGE.BAS SUPER.BAS would all be listed, but 
SQUARES.BIN TOAST.BAS and SQUARES would not 

The * wildcard can also be used in the type field of a filename (note, however that you cannot use it in 
place of the user number ot drive letter) If we wanted to list all files that had SQUARES as their 
name field and anything as their type held, we would use 

CAT "squares.*" 

Similarly if we wanted to list all the files that began with a letter S and had a type field that began with 
the letter B we would use 

CAT "s*.b*" 

When we type CAT ton us own) we want to list a II files on a disk Therefore. C A T is just a shorthand 
way of saying 

CAT "*.*" 

From the above you wil 1 notice that the * wildcard can omy be used as the last character in a field, and 
it is used to mean I don t care what other characters are present between here and the end of this 
field Sometimes however, you may want to specify a group of flies but need to be a little more 
discerning This is when you use the ? question mark wildcard (m either the name field or the type 
field). The ? wildcard means I don t mind what character happens to be in this specific position 

Therefore if we used the command 

CAT "?at" 

then the files listed would be all those that are three characters long, ending in AT but we don’t 
mind what character is in the first position Thus files such as CAT SAT MAT and FAT would be 
listed, but CAR CATTLE rnd A T would not U 1 ;, me the * wildcard ? wildcards can be used in 
place of any of the 8 characters of the name held and the 3 character? of the type field There is no limit 
to the number of question marks you car. use (other than the 8 and 3 limits of the tilename tield lengrlis) 

Valid file specifications containing ? wildcards include 

(one letter name with a type fiela : B A S 
(specific files whose second character dcesn; matter with at, y *ype field) 
(flies beginning C A with fcur characters m the name held, and with a 
type field of 3 characters whose second letter is T i 
(exactly the same as *. * 


?. bas 

s?uares.* 

ca??.?t? 

'in 
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If you have a printer connected to your +3 you may find it useful to print-out the files listed by C A T 
You can do this by directing the output from C A T to stream 3 (streams are explained in part 211 of this 
chapter). The command to do this ts. 

CAT #3 

If you only want some of the files pnnted-out. you can also include a file specification in exactly the 
same way as before. For example 

CAT #3,"a:*.bas" 

.The above CAT tt 3 commands will not work unless a printer is connected to the +3 and is on 
line To abandon, pres- BREAK) 

Any form of the CAT command may also end with the word EXP for example. 
CAT "a:" EXP The E X P is short for expanded, and as the name might suggest, gives you u 
little more information about the attributes of the files on a disk. Not only will the expanded catalog 
display system files but also it will indicated whether files are set to write protected mode archive 
mode or system status i these terms are explained in the section ahead entitled Fue attributes) 

(There is one other specialist use for the CAT command, and this will be dealt with in the sectio 
ahead entitled Tape catalog') 

Now that you have successfully saved a program to dnve A you can happny switch off or reset 
the +3 - i start a N E W program knowing that you could always load m the saved program if you 
needed it h'emember there is = difference between resetting Ihe +3 and using the NEW 
command -if you reset, all Ihe +3 s memory (RAM) will be cleared This includes any files you may 
have saved or. drive M When you use NEW, however any files or. drive M wiil remain intact Aswe 
have saved the pr grain n the disk tr. drive A . ye a can go .ahead and press the RESET button then 
release M The usual opening menu will be displayed Select +3 BASIC 'her. type the command 

LOAD "squares" 

The LOAD command road- in a new proqiun. '.and variables) from disk and then deletc-s any 
program and Variable ■-1 previously in the memorv ( 1! the program that you specified to load is ti t on 
the aisle 'hen any pi pram currently in the memory ts not deleted. Just like SAVE the LOAD 
‘coraniand must be given a filename whose name field is ai least charade! long. !f you have been 
used tc a tape machine in the past then you may have used LOAD ""to mean load the next 
program on the tape The concept of a next program on disk does not exist so if you don't specify a 
fuename the disk system v; -in t know what to lead and will report an error If you cant remember what 
name you saved a file utioe-i. use CAT to check what's on the disk (this is why it's a good idea to save 
ptugrams on disk using mnemonic names (names that remind you what they contain) • og it is mote 

TENNIS. B AS contaifisoomparedt mi T 

There ts a shori cut for loading programs (such as games.) that have been specially set up you can 
select the Loader option, from the opening menu This option, when selected attempts to load and 
run programs F irst of all, tt looks for a program called * on the disk If this exists then it will be loaded 
and run I tic program has m be a machine code program saved m a particular tashion (as BASIC can't 
use * as a filename for SAVE: and is therefore only for use cm commercial softw meet byih.se whe 
jiiderstand machine cod-: 
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If * can't be found, the +3 will then took for a fi.e called DISK This can be a BASIC program that 
you've previously written and saved, so it the L o a d e r option finds a program called DIS K, it will 
load it and wait for the next operation. 

At this point, pressing ENTER will just load the program again 

if you wish to rutt or edit the program after it has loaded, first press the cursor down key o once, then 
ENTER This selects the +3 BASIC opnon from the openi menu 

If there isn t a program called DISK on the disk (or it the +3 detects that there isn't a disk in the disk 
drive), then the computer will try to load a program from tape, displaying the message,, 

Insert tape and press PLAY 
To cancel - press BREAK twice 

Tins is the recommended method for loading Spectrum +3 (Spectrum +2 and Spectrum 128 
software from tape (see chapter 4) 

As previously mentioned, LOAD deletes the old program and variables in the +3 whenever it loads 
in the new ones from disk However there is another command - MERGE, which is similar to LOAD 
but it only deletes an old program line or variable if there is a new one with the same line number or 
name Clear the program memory using the NEW command, then type in the dice program from part 
11 of this chapter and SAVE it onto disk, using 

SAVE "dice” 

Use N E W to clear the- program memory again thet. ■ inter : l run thei lowing program.. 


1 

PRINT 

1 

2 

PRINT 

2 

10 

PRINT 

10 

20 

LET X 

= 20 

Now type 

ir 


ME 

:rge " 

dice 


If you then LIS T the program you wili see that unes 1 and 2 hove survived, but lines I' i and 20 have 
been overwritten by those from the dice program Note that the value of the variable x has aisc 
survived (try PRINT x 

You have now seen simple fotms of five of the commands that work in conjunction with disk 

Prepares brand new disks so that programs can be saved onto then 
FORMAT can be used to completely erase everyth;-a n a disk that In. 
already been used 

Stores the program and variables ento a disk. 

Clears the computer of all its program ana variables, ana replaces them with 
new ones read in from disk 


FORMAT 

SAVE 

LOAD 
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MERGE 


Similar t LOAD except that it does not clear the old program lines and 
variables unless it has to (because they are the same as those being loaded in 
from disk) 

CAT Displays a list of the files contained on a disk 

A variant on S A V E takes the form 

SAVE filename LINE number 

A program which is saved using this command, is stored m such a way that when it is loaded, it 
automatically jumps to the line with the given number, thenruns itself 


Use NEW to clear the program memory ther. type m the following . 

10 PRINT "program running" 

20 PLAY "cdefgabC" 

Now save this program using the command. 

SAVE "disk" LINE 10 

Now reset the +3 and when (he man menu appears ensut- that the disk (with the above program 
n it) is in the drive then press the ENTER key This wil. select the L o a d e r option which searches 
for a file on the disk called DISK When it finds the simple example- program you just saved, it wf, 
adit and as it wassa ved 'using a LIN E parameter, n will automatically start running (from line 10) 

Al this point presstr /1 ENTER will load ar.d run the program igau: 

if you wish to edit the program after tt has run press the cur ENTER Phis 

se.ectslhe +3 BASIC option from the opening menu 

Note that if you load a program, called DISK which deesnt automatically rur. (using the Loader 
•t.tton from the opening menu, then you wt" lw.e t- -select the +3 BASIC option (after the program 
has loaded) before you can run it or edit ii 

x tar. the only kinds of information we have stored on disk have been programs (together with then 
.mables, There t.ic twr :thei lands iflr.firn.dio: ; ; :i eoarrays- abytes 

You nan save. ni ays nai.x using th? keyword D AT A . SAVE statement 
SAVE : loti .in, DATA »ray f.an.* () 

where filename is the name that ihe information will have on disk ana works in exactly the same way 
as when you save a program 

The- -.may name specifies the array you want to save sc it is ust ■ :etter i i a .c ,er followed by $) 
Ben meet to put the brackets () •:*•:» 'he array rrir.e 


153 




Be clear about the separate roieso; filename and array name If you s-.y f for instance) 

SAVE "b loggs" DATA b () 

then SAVE takes the array b() from the computer ana stores it ;p. disk under the name 

BL0G6S 

The command, 

LOAD "b Loggs" DATA b () 

sees if it is possib!etc toad the array tie if there is room for it in the computer) thenifsc deletes any 
already existing' array called b () and loads m the array B LOG G S from rush calling it b () in the 
computer 

You cannot use M E R G E with ;;<ved arrays 

You can save character (string) arrays in exactly the same way However, note that when you load in a 
character array, it wil. aelete not only any previous character array with the same name, but also any 
simple string variable with the same name 

Whenttealmg with a large amountof data you nay find jtusefuUousethe SAVE data pti mi 
tiJt LOAD DATA ' 

by an array can be re-used Using drive M will mean that saving ana loading are very fast 

Byte storage is used for pieces of information without any reference to what the information is used for 
- it could be a screen disp lay ot perhaps some user-defined graphics or tusi something you have 
made up for yoursc: f It is specified using the w >rd C 0 D E as in.. 

SAVE "picture.bin" CODE 16384,6912 

The unit of storage in memory is the byte (a number between 0 anc 255 \ and each byte has an address 
(which is a number between 0 and 65535) The first number after C 0 D E is the address of the first byte 
to be stored on disk, the second number is the amount of bytes to be stored Inout case 16384 is 
the address of the first byte m the file (which contains the screen display) ana 6 91 2 is the amount of 
bytes in it. so we arc saving an actual copy of the screen display c me disk Try the above SAVE 
commana (You don't have to save the bytes using the name PICTURE.BIN - it's merely . 
convenient reminder of what's on the disk > 

To load it back use 

LOAD "picture.bin" CODE 

Yoiiounput parameters alt.- i CODE mo km. 

LOADm . m- CODE star', . .ith 
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Here the length parameter is used as a safety measure - when the computer attempts to load the 
bytes horn disk it will check the length and tefuse to load the bytes if there are mote than specified 
(thereby safeguarding against the extra bytes accidentally overwriting an area of memory that you 
wished to preserve) In such a case, the report Code length error is displayed (Anyone 
using a cassette unit under 4£ BASIC should note that the above etror will display a different report 
R Tape loading error) 

It you leave out the length parameter the +3 will read in the bytes however many there are 

1 he starf parameter shows the address where the first byte is to be loaded back to this can be 
different from the address it was saved from, though if they aie the same, then you can leave out start 
parameter m the LOAD statement 

CODE 16384,6912 is such a useful area of memory (the screen display) to save and load, ! hat 
:3p-, rul function SCREENS has beer, provided to represent it so you can type (for example) 

SAVE "picture.bin" SCREENS 

ox 

LOAD "picture.bin" SCREENS 


Automatic back-ups 


II you have saved one or two things on a disk and then you save something with a filename that has 
already been used what will happen" Well, each time you saveprogram the disk system checks r 
see if the filename you specily has already been used. If it has the existing copy on disk is given a new 
filename before the information you have asked to save is stored The new name given to the existing 
tile nas the same name field but tts type field will always be . BAK (short for backup) 

Ifa .BAKveraot ft xtsls, then that wffl be lost in preference to the i w. BAK file 

This means that as you save successive versions of a program with the same name the previous copy 
will still be there in a the called filename .BAK So if you make a serious programming error and 
inadvertently save the program, you can delete the newest version and rename the .BAK ft!- to the 
: ncnnal filename. The next section shows you how to do this, but first, type 

SAVE "arsquares" 

i. save *h'• t u pep am using t|c filename SQUARESyel agar 
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Deleting and renaming Hies 


Files car be deleted from a disk using the ERASE command This should be followed by a filename 
that specifies which file or files tobedelet ± just like CAT. you can use the wildcards * and ? tc 
identify a group of files, or you can specify the name in full if you only want to get rid of one particular 
file If you specify a sr.qle filename, that file will immediately be erased from the disk • so take care [f 
you specify a group ct files (by including * 01 ?) BASIC will ask you to confirm that you really mean t 
delete this group of files Typing Y will make the deletion process continue so if you have made a 
mistake, type N 

If. fr example you w n • .delete - hie from drive M -ahed F RED . BAS you would use 

ERASE "m:fred .bas" 

If drive M has already been set as the default drive then you don't need to induce the M at the start of 
the filename It doesn't hurt to include the drive letter anyway -and with as powerful a command a~ 
ERASE you mnht fee! safer if you dc To erase all the Wes on drive B yi uwi uldust 

ERASE "b:*.*" 

Before doing this. BASIC will ask (or confirmation 

Erase b:*.* ? (Y/N) 


and assuming that y. j t e. ■ - y mean to wipe ah ’he tiles from the disk ir drive B yc u we uld then type Y 

If you ask to delete a single file (or a gre up of tiles using the wilder.! us * ana ?, ana ihere are no hie; 

• • then the report Fi le not found wffil • ii pi y< d 

Note that ERASE : sowed by just > drn fetter (eg ERASE "m: " v.i.. rase all flies . the 
g ' Citieo drive without asking for confirmation Be careful therefore net t enter this fotn. of the 
command unless you redly mear. tc delete everything '.The ERASE process wt. stop and report a: 
error if a write protected disk cr file is detectea. 

The disk you have been using up to now has many copies cr the simp i- SQUARES prograt 
under different names.) ..n it This is a waste of space so you might as well erase those that arent 
needed What you want to do ir. effect is erase everything except SQUARES ah uch there is r. 
simple way to dc this) However some of the different files have the same fettersm common * you 
may be able to use Various: mts if * and ? spectficatt o ns t it d wn the amount q! typing See If y.v. i 

ERASE : ' ■ ■ .SQUARES 

One i fii-.- has to rs.r.- d it can be si. r.a new: arr.e usir.:: th MOVE: :: ■ •• a ('• r example •: 
th-p : : ur- M . ■ -d SQUARES 'he v:.i vavil i lie t BLOCKS i' Lobe 

:i ' ’ ’ll : ' r: rhviHjafl- : SQUARES ; :ti Iv 

SAVE "m:squares" 

MOVE "m:squares" TO "m : bLocks" 

CAT "m:" 
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Imagine we had saved a file called FRED and then after working on it and saving a new version with 
the same name, realised that we had made a terrible mistake and would like to recover the last 
version. This would be possible using the commands, 

ERASE "fred" 

MOVE "fred.bak" TO "fred" 

Unlike ERASE you cannot include the wildcards * or ? when renaming files 

MOVE will take into account the current default drive so the filename doesn t necessarily have to 
contain a drive letter. Note, however that it is not possible to use MOVE to rename hies between 
different ames The command. 

MOVE "a:fred" TO "b:eric" 

(for example) will fail with the error No rename between dr i ves repotted Instead, 
you can use the COPY command (explained ahead) followed by ERASE to achieve the desired 
result. 

File attributes 

M 0 V E has another use besides renaming files It can also be used to change the attributes of a hie 
Attributes are bits of information associated with a hie that tell you (and the computer) a little more 
about it 

There are three attributes that car. be changed The most useful attribute is write protection. Once a 
file's write protection attribute has been set, it will not be possible to erase it (or save a hie with the 
same name) until you remove the write protection It behaves a little like the wnte protect hole on the 
disk, but works just on individual hies Unlike the write protect hole, however, it offers no protection 
uiiainsi FORMAT which erases everything on 3 disk regardless of atinbuies You can set a file's 
write protection attribute to on with a command such as 

MOVE "squares" TO "+p" 

The letter P is short for protection (against overwriting). If you now try to use the command,, 

ERASE "squares" 

you will receive an error report saying F i le is read only 
To switch write ptute jtior. off use 

MOVE "squares" TO "-p" 

and you 11 be able to erase the hie as before 

In all the MOVE commands that change attribute • + means switch itand - meansswitchitoff 
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When you are using M 0 V E to change attributes, the filename car. include the wildcards * and ? Si 
to make all the ffieson drive M, write protected, you would use.. 

MOVE "m:*.*'' TO " + p" 

As always, the drive letter can be omitted iritis the current default drive 

You can repeatedly switch attributes on or off ’without causing an error so if you set write protect on a 
file that has already got write protection, it will just stay protected 

The second attribute that can be changed is known as the system status attribute. This is really 
provided just to be compatible with other CP M based computers, however if you do set a files 
system attribute to on, then you will notice that the file no longer appears m the list of files when you 
use CAT The system status attribute is identified by + S (or - S) m the M 0 V E command If you use 
the exjoanded catalog (re CAT EXP all the files will then be listed including system status files 
(which are followed by the letters SYS). You may also notice that any files that are write protected 
are followed by the letters P R 0 T You can use the system attribute to remove flies from a catalog if 
they would otherwise just clutter things up 

Bear in mind that you cannot have two files on the same disk with the same filename and different 
system status attributes, sc if you try to create or copy a file onto a disk where a file of that naim 
already exists (but is hidden from CAT) then the previous file will be deleted 

The final attribute you can change is known as the archive attribute, In an expanded catalog it shows 
up as A R C, and is identified by + A (or - A) m the M 0 V E command On the +3 the archive attribum 
ts of no practical use and is only provided for file compatibility with CP/M based computers 

Here are seme atfnbuie-settmg MOVE commands iee if you can preaict what they will d 

MOVE TO "+p" 

MOVE .bas" TO "-s" 

MOVE "s???.*" TO "+a" 

MOVE "tn:?.?" TO "-p" 

if you try to use any letter other than A S or P in setting or resetting attnbuies -1 if ihe attrtbutestttng 
is not two characters long, then you will receive the report Invalid attribute 

Quite often, a situation wiil arise when you would like to make a copy of one of your hies (to give to a 
friend perhaps ot lo put it on drive M so that it can be accessed quicker) The COPY command can 
be used to copy files from one drive to another and even 'o make complete copies of disks The very 
simplest form of the C 0 P Y command will look something like this 

COPY "a:f red" TO "m:" 

Phis means put a copy of the contents of the tile called FRED (which is presently on dnve A.) onr 
dnve M As no destination name has been specified (after M. i the new file will also be called FRED 

The name before the wotd T 0 is known as rh- source filename and the name after T 0 is the 
destination filename- 
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Tho command 


COPY "fred" TO "eric" 

will taste the contents cf a file called FRED on the default drive and copy it lo a file cal.ea ERIC 
aiso on the delimit anvo The files FRED and ERIC then contain the same information 

You cannot copy one file to another with the same name and on the same drive Trying to do sc will re¬ 
sult in the error report File already exists (or possibly File already 
in use 

The source flier an. :■ r copying from can include the wildcards * and ?. however m this case the 
destination filename has to be just a drive letter Sc for example 

COPY "a:*.ov l" TO "m:" 

'.vt',1 work (assuming that there are some files or. drive A that match this specification -mci horsier s 
■..I ti •on A. with a .OVL type held onto drive M Hi vvever. the command. 

COPY "a:*.bas" TO "m:*.bin" 

will 1ml with the error report Des t i na ti on cannot be wild 

Hi. COPY comm i a • -s r at copy any attribute miernidUor. associated with a fii< you have t set 
any attributes you require on the new file after copyinu 

COPY .vi. always list the files it is copying ir. two cclun-.rs I his will allow you to check (hat my 
wilde. r< i specification you use encompasses ail the files that you were intending to copy 

After copying a report will appeal to let you know how many flies were copied. (If you were copyirv i 
i gi oup of files, this may be useful to check that you have indeed copied ail the filesyou intended t. i 

lliereisaspi ' i.:i Mm fthe COPY command-.:- toll, ws 

COPY "a:" TO "b:" 

which 'will perform i complete sector by sector' copy of the disk in drive A to an already formatted 
disk i:i drive B Anything already stored on the disk: in drive B will be lost - sc ii there are only a few 
:i,esot. tho source disk to be copied it may be quicker to use 

COPY "a:*.*" TO "b:" 

IT.’! n if you have My one drive (A j. you cun us? the fact lhat the single mechanism car. be used as if it 
.von htv-' A •-’] nr .<■»& Tor example suppose you have a single drive system ana want to copy ? 

• BAS) from 
type 


COPY "a:*.bas" TO "b:" 
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Once the +3 has read pan of the first file t hat ends in . B A S it will ask - you to 

Please put in the disk for B: into 

the drive then press any key 

Simply follow this instruction After the +3 has written the information onto the 'dnve B disk, it wtii 
ask you to.., 

Please put in the disk for A: into 

the drive then press any key 

This process of swapping between disks will go on until all flies have been copied. Because the 
COPY command Will try to use any free space on dnve M , it is a good idea to cleat drive M (if 
possible) before doing a lot of copying (as this can reduce the number of disk swaps needed) 

As well as copying flies between dnves COPY can also be used to copy flies to the screen or to a 
printer (if connected) The command. 

COPY "words.txt" TO SCREENS 

will display the contents of a file on the default dnve called WORDS.TXT Any control characters 
(except carnage returns) will be filtered out This command cannot really be used tc look at BASIC 
program flies as they contain various control codes its mam use will be to inspect the contents of 
ASCII text files, such as those produced by a word processor. 

The command.. 

COPY "words.txt" TO LPRINT 

is similar tc the above, but this time the contents of the file will be sent to the printer In this case 
however, control codes will be sent to the punter If you have set the pirn; output to be via th° FS232 
with tokens unexpanded using FORMAT LPRINT "R";"U"). then this command can be 
used to export files to other computers Once again this command cannot be used for BASIC 
programs - it is intended for sending ASCII text files only 

People writing machine code programs may nr.d it easier to dc so on a lamer development machine 
However the tiles produced by this method Will probably not be recognised by the +3 as BASIC 
expects to find a 128 byte header at the start of each file which contains informant t used by the 
LOAD command However, once -a binary file has been produced ■ r a -f 3 formatted disk, it car, 
have a header of the correct type put on it using a command such as 

COPY "game.com" TO SPECTRUM FORMAT 

This will produce a new file on the same drive having the same name field but with a type field r' 
.HED■ ■ GAME.HED v 

it will be written to the default drive (as no dnve letter was specified) 
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Obviously this command will only be of use foi machine code files Headed files produced in this way 
will have the length patt in their header set to the c orrect value and the type part set to be a C 0 D E 
file However, BASIC cannot know what address the file should be loaded to, so the load address 
should be specified when the LOAD CODE command is used For example if the above program 
had been assembled to execute at 7000h (the h denotes a hexadecimal number) or 28672 decimal, 
then the headed file could be loaded with the command. 

LOAD "game.hed" CODE 28672 

As SCREENS files aie just another type of C 0 D E file, this technique can be used to 'import' screens 
designed on another machine, though they obviously wouldn't make much sense unless they had 
been tailored to fit rhe +3 s size arid layout 


The RAMdisk 

You may have been wondering what point there is m storing information m the RAMdisk (drive M,) as 
it will be lost once the +3 is switched off. Well perhaps the most obvious use of dnve M, is to store 
chunks of BASIC program (or routines) which can be merged (using MERGE M: filename) into a 
smaller program, in sequence This makes it possible to write about 90K of BASICprogram, and hold it 
ir. the +3 (though t: do this, the program structure has to be well defined). 

You can keep the various routines on a 3 inch disk and use COPY to put them into drive M before you 
run the program. The benefit of doing this is that dnve M, is much quicker to access than the 
mechanical drives (A. and B.). The mechanical drives, however, can hold much more data, so you 
might like to evolve a system using both disk and R AMdisx Careful design and planning will repay 
itself many times over in termsofspeed and performance 

One of the more interesting uses of the RAMdisk is m animation, where a series of pictures can be 
defined by a 'slow' BASIC program, stored in dnve M, then called back to ’he screen at hiah speed 
The- following program offers a taste of this Doubtless you can do fcettet. 


10 

INK 5: 

PAPER 

0: 

BORDER 0: C 


LS 




20 

FOR f=1 

TO 10 



30 

CIRCLE 

f *20,1 

50 


40 

SAVE "m 

:baL L" 

+ 

S T R $ (f) COD 


E 16384 

,2048 




50 CLS 
60 NEXT f 
70 FOR f = 1 TO 10 
80 LOAD "m:ba L L"+ STR$ (f) COD 
E 

90 NEXT f 

100 BEEP 0.01, 0.01 
110 FOR f =9 TO 2 STEP -1 
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120 LOAD "m:ball"+ STR$ (f) COD 
E 

130 NEXT f 

140 BEEP 0.01, 0.01 

150 GO TO 70 

Before running this program always make sure that drive M is empty If it isn't, first type 
ERASE " in: * . * " (typing Y at the (Y / N)prompt), then R U N 

Note that in line 40 of this program, the two numbers following CODE are the addTess in memory of 
the start of the screen (16 3 8 4) and the length of the top third of it (2 0 4 8). Bv saving and loading 
only the top third, the overall speed is maintained 

Tape operations 

(See chapter 10 (Peripherals for your +3) for details on how to connect a cassette unit to your +3 ) 

Much of what has been said in this section about the use of L0 A D. S A V E and M E R6 E on disk will 
apply equally on tape (if you have connected a cassette uni! to the +3). However, the commands 
FORMAT, COPY, MOVE, CAT and ERASE do not apply on tape (although there is a special form 
of C A T that can be used • described in the section ahead entitled Tape catalog'). 

As you will already know when you first switch on the +3 the default drive for all file operations is set 
to drive A. This means that if you use CAT ERASE LOAD, SAVE, etc, without specifying a drive 
letter, then +3 BASIC -will perform the operation on drive A . You will also know that the default disk 
can be changed using either,, 

LOAD "driveletter:" 


or 


SAVE " drive letter:" 

where drive letter is either A : B: or M: (which must include the colon) In fact you can also use 
T: as a drive letter, but only in this one special form of the L 0 A D and the S A V E command, 

LOAD "t:" 

After LOAD " t: " ail subsequent LOAD and MERGE operations are performed to tape (until 
changed backtodisk by, for example. LOAD "a:") Similarly, if you use 

SAVE "t:" 

then all future SAVE operations will be performed to tape (again, until changed back to disk by, for 
example, SAVE " a : ") Unlike A: B: oi M: when you use T: as the drive letter it will change 
only future LOAD. SAVE and MERGE commands. The default dnve used for MOVE, COPY, CAT 
and E R A S E will stay the same as it was before (as these commands have no relevance to tape). 
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If all this sounds a little complicated, a few examples might help to make it a little clearer. Assuming 
you have just switched on (or reset) the +3 . the default for all operations will be A. So if you now 
type. 


SAVE "in:" 

then the default drive for all subsequent operations will be set to drive M. (this is exactly the same as 
if the command LOAD "m: " had been used) Using the command.. 

LOAD "b:" 

will then set the default drive for all operations to drive B. For this sort of thing LOAD and SAVE 
operate m exactly the same way. 

If we now use the command. 

SAVE "t:" 

this will perform all future SAVE operations to tape, but all other commands will still default to drive 
B Using the command 

LOAD "t:" 

Will also perform all future LOAD and MERGE operations to tape, however the default drive foT all 
disk-only commands will still be drive B 

Finally, using the command.. 

SAVE "a:" 

will perform all future SAVE operations and all disk operations texcept LOAD and MERGE) to 
drive A L 0 A D and M E R G E will still be from tape, however 

Let's trytosaveoursimple squares'program onto tape Reset the +3 then type 

LOAD "squares" 

This should load in the piogram that we saved earlier It you press ENTER the program will be listed 
as follows . . 

10 POKE 22527+ RND *704, RND * 

127 

20 60 TO 10 

This is the program that you are now going to save onto tape, Any standard tape should work, although 
low noise tapes are preferable 
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Typem (he following. 


SAVE "t:" 

SAVE "squares" 

This will save the program onto tape using the filename SQUARES When saving tiles on tape you 
are allowed up to ten characters in the name. Unlike disk, you can use any characters you like and the 
name can include spaces. 

The +3 will display the message 

Press REC & PLAY, then any key. 

We shall first go through a dry run so that you can see what will happen when we actually do save the 
program later. This tune therefore, don't press REC and PLAY on your cassette unit jus! press a key 
on the +3 (foi ■ sample ENTER : and watch the border around the screen display You will see 
patternsof coloured horizontal stnpesasfollows 

Five seconos of led and cyan stripes moving slowly upwards, followed by a very short burst of blue 
and yellow stripes 

A short pause 

Two seconds of the red and cyan stripes again, followed by another short burst of blue and yellow 
stripes. 

While the stripes appear on the screen, you can also hear the sound of the data through your TV ?, 
speaker 

Keep trying out the above SAVE command (without actually operating your cassette unit ! untii you 
can recognise these patterns What s actually happening is that the information is being saved in two 
blocks and both blocks have a lead in' (which corresponds to the ted and cyan stripes) followed by 
the information itself (which corresponds to the blue and yellow stripes) The first block is a 
preliminary one containing the name and various other bits of information about the ptogram. and the 
second is the progiam itself togethr t with any variables present. The cause between them is rust a 
gap. 

Now let's actually save the program onto rape 

1, Wind the tape to an area that iseither blank ot that youaie prepared to overwrite 

2. Type 


SAVE "squares" 

3, Follow the instructions on the screen, le, 

Press REC & PLAY, then any key. 
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4. Watch the screen as before. When the +3 has finished (with the report 0 OK), stop the tape. 

Whenever you save a program to tape before clearing the saved program from the +3 s memory, 
you should always make sure that the program was correctly saved. You can check the signal on the 
tape against the program in the memory using the V E RI F Y command (this command isn't used on 
disk, as disks are not prone to the same sorts of enors as tapes are) 

1 Rewind the tape to just before the point at which yousaved the program. 

2. Type... 

VERIFY "squares" 

Play the tape. The border will alternate between red and cyan until the +3 finds the program that 
you specified, then you will see the same pattern as you did when you saved the program During the 
pause between the blocks the message Program: squares will be displayed on the 
screen, (When the +3 is searching for something on tape, it displays the name of everything it 
comes across,) If, after the pattern has appeared, the +3 displays the report 0 OK, then your 
program is safely stored on tape and you can skip to the section ahead entitled 'Verified OK , 
Otherwise, something has gone wrong -take the following steps to find out what: 

If the program name has not been displayed, then either the program was not saved properly in the 
first place: or it was but was not 'read back properly You need to find out which. To see if it was saved 
properly, rewind the tape to just before the point at which you saved the program, then play it back 
while listening to the TV's speaker The (red and cyan) lead-in should produce a clear, steady high 
pitched note, while the (blue and yellow) information part gives a much harsher screech 

If you do not hear these noises, then the program was probably not saved. Check that you were not 
i tying to save the program onto the plastic leader at the beginning of the tape When you have 
checked this, tty saving again 

if you can hear the sounds as described, then SAVE was probably alnght and your problem is with 
reading back 

It could be that you mistyped the program name when you savedn (in which case when the +3 finds 
the program it will display the mistyped name on the screen) On the other hand, perhaps you 
mistyped the program name when you verified it, m which case the +3 will ignore the correctly 
saved program and carry on looking for the wrong name flashing red and cyan as it goes. 

If there is a genuine mistake on the tape, then the +3 will display the report 
R Tape loading e r r o r which means m this case that it failed to verify the program. Note 
that a slight fault on the tape* itself (which might be almost inaudible with music) can weak havoc with 
a computer program Try saving the program again perhaps on a different part of the tape (or a 
different tape altogether) 
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Verified OK 


Now iet us suppose that you have saved the program and successfully verified it. Loading it back into 
the memory is just a matter of typing.. 

LOAD "squares" 

(Since the program verified properly, you should have no problem loading it.) 

LOAD deletes the old program (and variables) in the memory when it loadsin the new one from tape 

Once a program has been loaded, the report 0 OK will appear The program can then be run or 
edited. 

As mentioned m chapter 4. n is possible to buy pre-recorded programs (software) on tape. They must 
be specially written for the ZX Spectrum range (le. the Spectrum, the Spectrum +. the Spectrum 128, 
the Spectrum +2 or the Spectrum +3) Different makes and models of computer have different 
ways of storing programs, so they cannot use each other s tapes. 

If your tape has more than one program stored on the same side, then each program will have a name 
You can choose the program you wish to load using the LO A D command • for instance, if the one you 
want is called HELICOPTER, you could type 

LOAD "helicopter" 

The command LOAD "" means 'load the first piogram that the +3 comes across on tape' This can 
be very useful if you cannot remember the name that you saved the program under! (Remember that 
this only works on tape - norma lly you cannot specify a blank filename) 

When there is no disk in drive A (or the disk contains no file called * or DISK), then the option 
Loader from the opening menu has the same action as LOAD "" from tape, and is much 
quicker to use-simply switch on (or reset) the -f 3 and press ENTER 

MERGE will operate in a similar way to that described for disk except, of course, that on tape you ca: 
use M E R G E " " to mean merge the next file on tape Filenames in a MERGE command may 
conform to the less stringent limits for tape (le any combination of 10 characters including spaces) 

If you have BASIC programs saved on tape (perhaps because you owned a previous Spectrum 
model), you will probably want to transfer them to disK to gain the advantage of faster loading This 
shouldbeielativelystraightforward Just use. 

LOAD "t:" 

SAVE "a:" 


then for each BASIC file on the tape. use. 

LOAD "" 


166 



which will load the next file from the tape into rhe +3 s program memory. Once loaded, thefilecan 
be saved out to disk using 

SAVE filename 

Remember that files on disk must be given a filename which conlorms to the limitations outlined at the 
beginning of this section 

If the BASIC programs have been saved with an automatic execution LINE you will find that 
attempting to LOAD them will also run them. Obviously you don't want this so, for each program you 
wish to load, reset the computer, select +3 BASIC and type 

MERGE "" 

(ratherthan LOAD "") 

If you have saved data (numeric or stnngi arrays, it should be an equally simple matter to LO A D them 
into memory horn tape then SAVE them to disk. 

The only file types that may cause difficulty when you want to transfer them from tape to disk are 
CODE ^and SCREENS) files. To be able to transfer a file of this type you need to know at least two 
things about it, 

1. The address it wassaved from, 

2 How many bytes it contains 


Tape catalog 

This is where (he final form of the CAT command comes m If the file specification given is simply T : 
a special form of the CAT command comes into action. After you type 

CAT "t:" 


the +3 will wait for you to play a tape (the CAT " t: " operation can be abandoned by pressing 
BREAK i When the +3 finds a header on'ape it will display the information (in the same form it was 
saved) This means that there will be a ten character filename in inverted commas What follows the 
filename will depend upon the type of file - if it is a BASIC program, the word (BASIC) will be 
displayed If a LINE parameter was specified when the hie was saved this will also be shown- If the 
file holds data then the word DATA followed by the array name will be displayed, and finally, if the 
file was saved using CODE (or SCREENS which is really just CODE 16384,6912) the 
word CODE will be printed fo. lowed by the start address and length that were specified when the 
file was saved 
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Here is a sample display resulting from a C A T " t: " command, which may make this a little 
dearer 




" s i mp L e 

" (BASIC) 

"execute 

" LINE 

10 (BASIC) 

"numbers 

" DATA 

f () 

"words 

" DATA 

C$() 

"m / c 

" CODE 

30000,12345 

"picture 

" CODE 

16384,6912 


The last item was. in fact, saved usina.. 

SAVE "picture" SCREENS 

lust like the otherforms of CAT itsoutput can be directed to a printer usingstream j le 

CAT n 3/'t:" 

(Streams are explained m par' 22 of this chapter.) Note that the above CAT A 3," t: " command 
will not work unless a printer is connected to the +3 and i? online To abandon, press BREAK 

from the above it can be seen that if you have ioadea (using MERGE " "i a program containing an 
execution LINE parameter, the CAT "t: " display will identify that Line number for you Yen 
may then wish to save that program tc disk using 

SAVE filename LINE .me number 

so that the disk version of that program runs itself automatically 

It is the values for the CODE files that you will probably find most useful frerr, the CAT " t: " 
display Either note them down or print then out Then rewind the tape so it is ust befcre the header 
that has been read Type 

CLEARstart-. 

where start is the vame printed feu the start address Now type 

LOAD "" CODE 

When the file has loaded into memory and the 0 OK report appears the the car. be saved ft Jis-: 
usina 


SAVE filename CODE 'tart,length 
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Hus technique is only intended for transferring your own code hies (where you may have forgotten 
what start and length values were used when you saved 'hen:) Note that using this method to copy 
commercial software may be a breach of copyright • check with the software authot first. 

Thet e are seversl reas ns why this simple scheme may nor work 

1. The code when loaded would overwrite some of the system variables (m the range 23296 (5B00hj to 
2375S (5CC6h)). This upper address limit may vary • it is the value held in the system variable PROG 
(see part 25 of this chapter). 

2 Attempting to load code t hat has no header (or that is protected m some other way) probably won t 
even produce any output from CAT " t :" and yt i certainly won't be able to use the 
BASIC LOAD command to load it 

3 If the coae file is so long that it siretches right ftom the- screen display aiea to the end of memory, 
then it wil. be possible to load it but as soon as it has loaded the machine will crash This is because 
BASIC will have lost its stack 

Exercise 

I Practise the operations shown m this secnon until you are completely au fait with manipulating files 
to and from the disk theRAMdisk ana cassette unit (if conceded) 
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Part 21 

Printer operations 


Subjects covered... 

Parallel printers 
Serial printers 
LPRINT, LUST 
FORMAT 
COPY 


The +3 omes with an 8 bit Centronics parallel port and an RS232 serial port Both are supported by 
built-in software enabling you to use virtually any printer These features are usable only 
in +3 BASIC mode 

The pnnter must have either a Centronics compatible (parallel) or an RS232 (serial) interface, and if 
you want to reproduce pictures of the screen, then the printer must have an Epson compatible 
guadrupJfj-density bit image graphics mode (ESC L n n) 

Make sure you have the correct lead to connect the printer to tin +3 if in doubt, consult your Sinclair 
dealc) 

Tor further information about which printer and .connecting lead to purchase, together with details ;f 
the +3 s PRINTER n IRS232 socket nnectkms ertpheralsforyom +3) 


Parallel printers 

When the +3 is first switched on it will assume that, if a printer is present it will be connected to th- 
PRINTER a clot I he hardware connection between computer and printer is reJ tivi 
straightforward ■ though you must make sure that you dor, t connect the cable the wrong way up at the 
computer end (if the cable doesn t have a locating key ) 

Once the connection has been made the command 

LPRINT "hello" 

b • tpi du© somi printed outpat If not check itt a hnecli - . i t - ■ ■ ■ 

set to on line 

Once you have got your printer to print, you may skip to the section ahead entitled Genera) printing 
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Serial printers 


Unlike parallel printers the connections between the +3 and s serial; or kS232) printer will vary for 
different manufacturers printers Make- sure that your dealer has provided a lead suitable tor 
connecting your particular printer to the +3 A serial printer must be cor.:.' eted to the + 3 s RS232 
socket and details of connections can be found m chapter IDfPeripherals for your +3) 

The +3 always uses what is or.own as hardware flow control, or hardware handshaking This means 
that it will not transmit characters 'until certain control signals from, the primer have the right values. It 
is therefore very important that connections are made to the control lines f the +3 as well as the 
transmit ana receive data lines If your printer does noi support hardware handshaking ther. connect 
pins 4 Tin ; : the +3 RS232 onnector socket together The drawback of riot using hardware 

handshaking is lhat the odd character may be lost when transmitting a lot of data at high speed 

+3 d the printer communicating with each other they must both use the same baud 
rate The baud r • tc lslhespeea at which data is transferrea between computer and printer Although 
it is possible that your primer car. be set to ailteTent bauu rates, it 11 probably be easier to change the 
rale at the computer end Somewhere in the printer s operating manual, the baua rate will be 
specified -find thi: ut and then set the +3 tc this i ate usir rtheo-nrnar.d 

FORMAT LINEbaudrate 

For example 

FORMAT LINE 300 

(You wot theedtc dfl thisifyourpnntt i norma ^ uses 9600 band,asthe +3 v unethi 
default i 

+3 usually expects (c be opcxeuifig with a parallel (Winter it will be necessary to 

command 


FORMAT LPRINT "R" 

b<::or-- the +3 wi.. sucoessnilly 'T*WK with a printer (The R in the above command >s short 
for KS23? ? 

The oil ''I..- +3 bn-ktcparaV:. l C>r.trcr.i:-simcdi:k 

FORMAT LPRINT "C" 
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General printing 


Once you have every thing set up. you can use three BASIC commands to print things out The fust two 
L P R IN T and L LIS T arc rust hie PRINT and LIST except that they use the printer instead of 
the TV screen Note that the Print option from +3 BASIC's edit menu has the same eifect as 
LUST, but is included as an easier method of getting a listing. 

Try this program fen example. 

10 LPRINT "This program. . 

20 LLIST 40 

30 LPRINT ’"...prints out the 
character set, ie..."’ 

40 FOR n=32 TO 255 
50 LPRINT CHR$ n; 

60 NEXT n 
70 LPRINT 

It's importer.! i- note that LPRINT and LLIST normally tare care to screen nut any enbeoctea 
colour codt(ana their parameters) before printing or listing anything Embedded colour codesare a 
bit ofa harm verir. ; th : .148K Spectrum when included tn .i string they set INK PAPER anas 
on Printers or. the whole tend to use these codes for completely different things like setting italics 
underline etc so it would be quite dangerous to send colour codes to the printer and hope that 
I happens A side effect oi this is that the +3 will normally not be able t: send 
escape control sequences \ the printer t i example suppose your ppm- - ’ xpects an escape 
charactet (ctitractei by " x"; C HRS (1) t sntch t 

normally use the command 

LPRINT CHR$ (27);"x"; CHR$ (1);" 

This is in Near Letter Quality" 

Hi w< 'Ver tn +3 BASIC, y .i mist first issue thee; mtnatio 

FORMAT LPRINT "U" 

+3 ' ' 1 but 

unexpended characters (the U is short Vr .mexpandedl If the above comma:;.i is not issued then 
lb : +3 

■ ' t tokens . ryt a ■ . ■ 

ffy : wi th instruct the +3 to ml tet 

FORMAT LPRINT "E" 

.vlir-rr E • i ■ i .vpir. !• 1 V u . eu o. tin;y. ut- LLIST Th +3 ••art. 

F ORMA T LPRI NT "U" 

y .tv • | - a I i- FORMAT LPRINT "E" 
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So, to summarise. 


* If you want to send special characters (such as ESCj to your printer (m order to use different styles 
of printing), issue the command. 

FORMAT LPRINT "U" 

before printing. 

* If you are writing or modifying a program, and want to get a listing on the printer, issue the 
command.. 

FORMAT LPRINT "E" 

before listing the program 

The third BASIC statement used with a printer COPY prints out a. -opy of the TV screen To 
demonstrate, go mtc the small screen (by selecting the Screen ipnon from the edit menu) and 
type m the following command, 

FOR n=1 TO 20: PRINT n,: NEXT n 

Tire numbers 1 to 2C will be printed m the top par: of the screen. New type 

COPY 

The COPY command takes about 15-30 seconds tc get started sc dont panic if n thing appe astc 
happen immediately After a while, you 11 see a copy <f the screen reproduced on the primer , I! all 
COPY ■ ■ : haiactet | t'sli npnnti 

filly compatible i 

BREAK :i ■ : .. 

wr. is a buffer which stores text before printing If your printer has-1 thr-r. pressing BREAK 
will not stop the printer immedia'ely (although the +3 will register the bit 1 .: m, nee/ 

N'. re that i: 'he COPY c:tr.n:ana is stopped by pressing the BREAK ,:ey ’he printer may be .eft in 
graphics mode this wr.l be indicated by subsequent LPRINT statements producing a mass of 
meaningless acts, or priming each lire: f text partly over the previous line) In these circumstances, 
switching the printer off then on again is the easiest way to get things back to normal 

As 1 is the rather sirs COPY • h 1 tpi black -dot on the printer for 

dc-t on the screen whatever Its colour may be thete :s an excar.dea versicr. COPY EXP which 
prints differin j .•••mbm.-ttirns .-.f nets depending or, the - u i- that was gseo. n the screen 7 

iero mstrate type tn the renewing newprrgrarr. 
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10 FOR b = 0 TO 1 
20 BRIGHT b 
30 FOR i=0 TO 6 
40 FOR c=0 TO 31 
50 PRINT INK i; i; 

60 NEXT c 
70 NEXT i 
80 NEXT b 

(henswitch t thr bottom ivart of the screen (using the edit menu's Screen :ption) Run thr 
program (which displays twelve lines of coloured numberson the screen, then tvpe ir. 

COPY EXP 

I’ht prim?! i output (or dump) from this command is slightly larger than that fr r th< iandara COPY 
E X P is short for ■ f ■ he set 

as different densities of black dots on the printer (All 24 lines of the screen arc reproduced ) Area; 
that hav b< pt tl BRIGHT 1 WI ippi si hghterthan n 
happens on the scree:]: 

he drawback thi C0 DV exp 

but is ideally suite -1 to duinptr ; graphic pictures TV ; ikver COPY command 1 the other Ivcxi 
a better bet if you wish ti 'Jump text only 

If the screen display to be dumped is predominantly black, the r. it will net only wear out your pt inter 
ribbon rather quickly but also v;i I probably also, inks . i t<■ lumr than screen that has large 
ate as of white T> pr-'ver:t the the COPY EXP • int:- : d m hr : .-wed by the 'it 

INVERSE ie 

COPY EXP INVERSE 

As the command suggests the dump is printed m INVERSE 
all the dark areas of the screen are pnntedout light and vice v< rsi 

Not< that INVERSE c.mti i b-' used after the sir;: COPY emmand it only wyk; with 

COPY EXP 

The dump produced by COPY EXP and COPY EXP INVERSE is desrmod t- fit ■ shed d 
M paper, however some printers wi not print within about an inch at • >ther end. / a sheet I) this 
problem occurs, then it is possible to reduce the sur of the dump slightly bv ustn-r the ct imnrard 

POKE 23419,8 

This sets the numbr r of 2 i 6ths inch used as a line feed at the end of each pass r >: tin print head It is s>: t 
■ .'. t ■ +3 fu witched on Once set rlwilinotbt changed mfthc new ®mn 

used By reducing this vail* each passe: the print head vvill fractionally c verlay the previous oass As 
. consequence the quality of the dump reproduced will be degraded slightly 
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If yuu try to Use any ;>f the pi inter commands when there tsn t a printer attached (or if the printer is off 
line) then the +3 Will stop dead while it patiently waits for the (non-existent) printer to respond. In 
such a case, ptc-ssm • BREAK twice will bung the -f 3 bad-' to life- 

Try this 

10 FOR n=31 TO 0 STEP -1 
20 PRINT AT 31-n,n; CHR$ ( COD 
E ”0"+n); 

30 NEXT n 

You wiil see a pattern of characters working down diagonally from the lop right-hand corner until it 
reaches the bottom ot the screen, at which point the program asks if you want to scroll 

Now change AT 31 - n, n in line 20 tc T A B n The program will have exactly the same effect as 
before 

Now change PRINT m line v ;■ LPRINT This time then' will ben, pans-., to scroll (this does not 
occur v/ilh the printer) 

Now change- TAB n back tc AT 31-n,n still using LPRINT This time you will get lust a 
single line of symbols The reason for the difference is that the output from LPRINT is rot printed 
straightaway, but is stored in the buffer until either one lines worth ol printer output has accumulated, 
or something else flushes' the buffer Hence, printing only takes place 

1 When the buffer is full 

2 After iri LPRINT stan iment that ones not end in a comma cr semicolon 

3 When ii- on,, ,pijstrophcor TAB item requiresa new fine 

4 At the end ola program it there is anything left unprintod 

r > When you ?■ t the printer off line (.this depends on your particular printer) 

Number 3 above --xpl-ans why our pr< gram with TAB works the way it decs A? for AT the .me 
in.Lot is igr.i r* "t at.o th- LPRINT t situ::. th, PRINT pc,ah, : is o d ' the ..mn: 
number An A T item can never cause a me to be sent to the printer 


fixe roses 


; Make a printed graph of a sine wave by running the first (3 line) program m part 7 of this chapter 
then using COPY 

3 Run the program at th-- bt ••tinning of pm to o! this chapter and try both , COPY EXP and a 
COPY EXP INVERSE 
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♦* 


Part 22 
Streams 

Subjects covered.., 

Streams 

Channels 

FORMAT,OPEN,CLOSE 


The +3 can ‘read’ data from the keyboard by using INPUT and IN K E Y $, and it can 'write data 
onto the TV screen or a printer by using PRINT and L P RIN T, However, these commands are 
really a form of shorthand designed to protect the user from some of the computet s more complex 
features, 

To the BASIC PRINT command for example, the screen and the printer are no different 
PRINT "Rosanne" really means ‘take the character? which make up the word Rosanne 1 and 
send them somewhere else. It's just convenient to use the screen most of the time Likewise 
L P RIN T usually sends data to the printer In fact, what these commands really do is to send data tc 
one of a number of channels 

A channel is the way in which the computer communicates with its input and output devices. There 
are three channels normally available to BASIC These are. 

* The screen (called S) 

* The keyboard (called K) 

* The printer (called P) 

Of these, the screen is an output-only device, the keyboard is both an input and output device, and the 
printer is either an output-only device (if it uses the parallel PRINTER socket), or an input and output 
device (if it uses the serial RS232 socket) Outputting data to the keyboard might seem a funny idea 
but the computer uses the lower screen (like INPUT does) to display the characters. 

To access a channel, it has to be open Opening a channel makes it ready to receive or produce data, 
A channel is opened by connecting it to a stream From BASIC, you would use a command like 

OPEN #4,"p" 

which means 'connect stream 4 to the printer channel'. Streams are convenient ways for the 
computer to switch between channels by referring to them as numbers This idea makes it possible to 
write programs that can send information to any device without having to use different commands, 
(This is known as reairectable (or device-independent) I/O) 

This might seem over-complicated, and you may well wish to stick to the standard PRINT and 
L P RI N T commands - that's why they're there, after all 
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PRINT and LPRINT are really the same command When BASIC is running, it has three streams 
normally open Stream ti i is connected to the keyboard device (K), and is used by INPUT and 
IN K E Y $ Stream #2 is connected to the screen (S), and is used by PRINT and LIST Stream U 3 
is connected to the printer (Pi and is used by LPRINT and LLIST Allofthesecommanclscap.be 
redirected to use another device by including a # followed by a current stream number, sc - 

PRINT #1;"This is the Lower screen" 

will print the message on the lowet screen. Similarly .. 

PRINT #3;"Who needs LPRINT, Gladys?" 

will use the printer. Conversely. L P RIN T can behave like PRINT 
LPRINT #2;"Confusing, or what?" 
behaves just as if the LPRINT #2 were PRINT 

As they stand, these examples are fairly useless but serve to demonstrate a point This sort of thing 
becomes useful if you want tc write a program where the results might go either to the printer or the 
screen, like so,,. 
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40 

IF a$ 
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"y 
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9* 

II 

HS 

THEN 

LE 


T stream=3 
50 FOR n=0 TO 10 
60 PRINT #stream;n,n*n 
70 NEXT n 

The +3 can cope with 16 streams As 3 axe used by BASIC, and 1 is used internally, this leaves you 
with 12, You can use these by.. 


10 

REM program 

to r 


om RS232 


20 

FORMAT LINE 

9600 

30 

FORMAT LPRINT "r 

40 

OPEN #4,"p" 


50 

PRINT INKEYS 

#4; 

60 

GO TO 50 



which takes characters m from the RS232 interface and punts them onto the screen 
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♦v 


If you want to read in data from the RS232 into memory directly, you can replace line 50 with 
POKEaddress, CODE (INKEVS #4) 

As we mentioned before, the screen and the parallel PRINTER socket can only be used .by the 
+3 for output. They cannot be used for input, and if you try P RIN T IN K E Y $ #2 for example 
you’ll receive an error report 

It is theoretically possible to redirect B ASIC's norma I output streams, so by using... 

10 CLOSE #2 
20 OPEN #2,"p" 

all the PRINT output will go to the printer instead of the screen (If you try to do this during editing 
the results will be unpredictable, so it's best left alone) 

On the standard +3 system, streams and channels are of mostly academic interest However 
certain peripherals and BASIC language extensions do use the stream system for more complet 
functions 
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Part 23 
IN and OUT 

Subjects covered... 


IN 

OUT 


The processor can read from (ROM and RAM) and write to (RAM) memory by using PEEK and 
POKE The processor itself does not really care whether memory is ROM or RAM • it just thinks that 
there are 65536 memory addresses, and it can read a byte from each one (even if it's nonsense), and 
write a byte to each one (even if it gets lost). In a completely analogous way, there are 65536 of what 
aTe called I/O ports (standing for mput/output ports). These are used by the processor for 
communicating with things like the keyboard or the printer, and also for controlling the extra memory 
and the sound chip. Some of them can be safely controlled from BASIC by using the IN function and 
the OUT command, but there' are locations to which you must not write from BASIC as you will 
probably cause the system to crash, losing any program and data, 

IN is a function like PEEK Its form is, 

IN address 

It hasone argument - the port address, and its result is a byte Tead from that port. 

OUT is a statement like POKE Itsformis 

OUT address, value 

which writes the given value to the port with the given address How the address is interpreted 
depends Very much upon the rest of the computer. Quite often, many different addresses Will mean 
the same On the +3 it is most sensible to imagine the address being written in binary, because the 
individual bits (each of which can have the value either 0 or 1) tend to work independently There are 
16 bits, which we shall refer to (using A for address) as,, 

Al5, A14, A13, A12. All A10, AS, A8. A7. A6, A5. A4, A3, A2, Al, AO 

Here, AO is the Is bit, A1 is the 2s bit, A2 is the 4s bit, and so on. Bits AO, A1 A2, A3 and A4 are the 
important ones. They are normally !, but if any one of them is 0, then this tells the computer to do 
something specific The computer cannot cope with more than one thing at a time, so no more than 
one of these five bits should be 0 Bits A6 and A7 are ignored, so if you are a wizard with electronics 
you can use them yourself. The best addresses to use are those that are 1 less than a multiple of 32, so 
that AO to A4 are all 1. Bits A8, A9, and so on are sometimes used to give extra lmormation, but mostly 
for the extra memory and sound 
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The byte being written or read has 8 bits, and these are often referred to (using D for data) as . 

D7.D6, D5 D-i. D3, D2.Di.D0 
Here follows a list of the port addresses used. 

There is a set of input addresses that read the keyboard and the tape interface. 

The keyboard is divided up into 8 half-rows of 5 keys each, viz: 


IN 65278 (TTFEh) reads the half-row CAPS SHIFT to V 
IN 65022 (FDFEh) reads the half-row A to G 

IN 64510 (FBFt'h) reads the half-row Q to T 

IN 63486 (F7FEh) reads the half-row 1 to 5 (and JOYSTICK 2) 

IN 61438 (EFFEh) reads the half-row 0 to 6 (and JOYSTICK i i 

IN 57342 (DFFEh) reads the half-row P to Y 

IN 491 50 (BFFEh) reads the half-row ENTER to H 

IN 32766 (7FFEh) reads the half-row (space) to B 


(These addressesare254+256x(355-2 J n) as n goes from 0 to 7.) 

Remember that digits followed by h signify hexadecimal numbers If you don't understand these, 
refer to part 32 of this chapter 

In the byte read in. bits DO to D4 stand Tor the five keys in the given half-row DO is for the outside key, 
and D4 is for the one nearest the middle The bit is 0 if the key is pressed, i if it is not, D6 is set by the 
tape interface, and iseffectively random if no tape data is present 

For JOYSTICK i, bit 0 is fire, bit i is up, bit 2 is down, bit 3 is right and bit 4 is left For JOYSTICK 2, bit i 
is left, bit 1 is right, bit 2 is down, bit 3 is up and bit 4 is fire. From BASiC, these read as the number 
keys 

Port address OOFEIi (254 decimal'm output drives the sound (D4) and the save signal to the tape 
interface (D3), and also sets the border colour (D2, D1 and DO) 

Port addresses OOFEh (254), OOF7h (247) and OOEFh (239) are reserved 

Port address 7FFDh (32765) drives the extra memory Executing an 0 U T to this port horn BASIC will 
nearly always cause the computer to crash, losing any program ana data. There is a fuller description 
of this port m part 24 of this chapter (ur.deT the heading Memory management ) This port is write oniy 
le. you cannot determine the current state the paging by an IN instruction Hus is why the BANKM 
system variable is always kept up to date with the last value output to this port 

Port address BFFDh (49149) drives the sound chip's data registers Port address FFFDh (65533) in 
output writes a register address and in input reads a register Judicious use of these two i agisters can 
allow sounds to be generated whilst BASIC gets on with something else, but you should be a ware that 
they also contrc RS232/MIDI ana AUX interfaces 

Poll address OFFDh (4093) is used for the parallel (Centronics) interface (le PRINTER) When tead 
using an IN instruction bitshows the slate of the BUSY signal produced by the printer I! the printer 
is off tine or non-existent, then this bit will bo When this port is written t; using OUT it acts as the 
parallel port data register In order to print a chaiactei it is necessary to wait until BUSY is 0, write the- 
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character code to port OFFDh (4093), and finally, take the STROBE bit in port IFFDh (8189) low then 
back high again 

Pert address IFFDh (8189) controls several aspects of the +3 Amongst other things, this port 
controls the ROM that is switched into the memory area from QOOOh. 3FFFh (0.16383), As the port is 
wnte only, +3 BASIC maintains a variable. B ANK678, that holds the value last output to this port. It is 
therefore very unwise to OUT values directly to this port without first checking on the current state 
and sethng/resettmg only the bits you are interested in This is also the case for the port at 7FFDh 
(which holds its current state tn BANKM), The bottom three bits (0, .2) of this port (1 FFDh) are used to 
switch RAM/ROM • further details can be found m part 24 of this chapter (under the heading Memory 
management'), Bit 3 controls the disk motor (0 is off; 1 is on), though it should not be necessary to 
control the motor by writing to this port as there are +3DOS routines that will achieve the desired 
effect, Bit 4 is the parallel port STROBE which is active low - this means that to print the character that 
has been output to port OrFDh (4093), the STROBE bit should be brought low and then returned to its 
normally high state. 

Port address 2FFDh (12285) can be used to read the disk controller 0rPD765A) chip's main status 
register This is unlikely to be very useful without an in-depth knowledge of how the chip operates 

Port address 3FFDh (16381) is the disk controller's data register. This can be both read from and 
written to, but once again it is unlikely to be useful to the BASIC programmer Random OUT putting to 
this port will probably confuse the poor disk controller chip to such an extent that subsequent disk 
operations (like LOAD and SAVE) will be unreliable It is entirely possible that ill-informed 
experiments will corrupt your disks and lose your data - you have been warned 1 

Run this program to see how the keyboard works,, 

10 FOR n=0 TO 7: REM haLf-row 
number 

20 LET a=254+256*(255-2 T n) 

30 PRINT AT 20,0; IN a; GO TO 
30 

and play around by pressing keys (start with the half-row from CAPS SHIFT to V) When you 
finished with each half-row press BREAK and then type 

NEXT n 

The control, data and address busses are all exposed at the back ol the +3 cn the EXPANSION I/O 
socket. This means that you can do almost anything with a +3 that you could with a raw ZS0 chip 
(although sometimes, the computer's internal workings may get in the way). 

See chapter lOforadiagram and pm-out of the EXPANSION l/Osocket, 
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Part 24 
The memory 

Subjects covered... 

PEEK 

POKE 

CLEAR 

Memory management 

Deep inside the +3 everything is stored as bytes ie. numbers between 0 and 255 (FFh) You may 
i hi nk you have stored away the price of Ruddles or the players' names m the Arsenal football team, but 
m fact, all the information has been converted into collections of bytes, and bytes are what the 
computer sees, 

Each place where a byte can be stored has an address, which is a number between 0 (or OOOOh) and 
65535 (EFTFh), This means that an address can be stored as two bytes You can think of the memory as 
a long row of numbered boxes, each of which can contain a byte Not all the boxes are the same 
however ■ the boxes from 4000h to FFFFh are RAM boxes, which means you can open the lid and alter 
t he contents, but those from 0 to SFFFh are ROM boxes, which have a glass iid that cannot be openeO 
-you just have to read whatever was put into them when the computer was made fn the +3, we have 
crammed in more than twice the amount of memory than can comfortably fit. While the processor can 
address 65556 bytes, there are m fact 131072 bytes of RAM and 65536 bytes of ROM making 136608 
bytes (192K) in all! All this is hidden from the processor by the hardware using a process called paging 
BASIC (and the processoi) always sees the memory as 16K of ROM and 48K of RAM (or 64K of RAM 
with no ROM ■ though this latter combination is never used by BASIC) 


65535 


49152 


32768 


16384 


RAM 0-7 


RAM 2 


RAM 5 


ROMO-3 


FFFFh 

COOOh 

8000h 

4000h 

OOOOh 


The +3 memory map 
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To inspect the contents of a box, we use the P E E K function. Its argument is the address of the box 
and its result is the contents. For example, this program pnnts out the first 21 bytes in ROM (and their 
addresses) 

10 PRINT "Address"; TAB 8; "By 
te" 

20 FOR a=0 TO 20 
30 PRINT a; TAB 8; PEEK a 
40 NEXT a 

All these bytes will probably be quite meaningless to you, but the processor chip understands them to 
be instructions telling it what to do. 

To change the contents of a box (if it is RAM) we use the P 0 K E command. Its form is. 

POKE address , contents 

where address and contents are numeric expressions. For example, if you type 

POKE 31000,57 

. then the byte at address 31000 is given the new value 37. Now type,. 

PRINT PEEK 31000 

...to prove this. (Try poking m other values, to show that there is no cheating.) The new value must be 
between -235 and +2S5, if it is negative, then 256 is added toil 

The ability to poke gives you immense power over the computer if you know how to wield it, and 
immense destructive possibilities if you don't. It is very easy (by poking the wrong value into the 
wrong address) tc lcse vast programs that took you hours to type in Fortunately though, you won't do 
the computer any permanent damage 

We shall now take a more detailed look at how the RAM is used Don't bother to read this unless you're 
really interested. 

The memory is divided into different areas (shown in the diagram ahead) for storing dilferent kinds of 
information. The areas are only large enough for the information that they actually contain, and if you 
insert some more at a given point (for instance by adding a program line or variable), then space is 
made by shifting up everything above that point Conversely if you delete information, then 
everything is shifted down 

The display file stores the contents of the TV screen. It is rather curiously laid out, so you probably 
won t want to P E E K or P 0 K E in it Each character position or. the screen has an 8 x 8 grid of dots, 
each dot can be either 0 (paper) or ! (ink), so by using binary notation we can store the pattern as 8 
bytes-one for each row However these 8 bytes are not stored together The conespnndmg columns 
in the 32 characters of a single line are stored together as a scan of 32 bytes, because this is what the 
electron beam in the TV needs as it scans from the left-hand side of the screen to the other Since the 
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complete picture has 24 lines of 8 scans each, you might expect the total of 192 scans to be stored in 
order, one after the other - well, you'd be wrong' First come the top scans of lines 0 to 7, then the next 
scans of lines 0 to 7, and so on to the bottom scans of lines 0 to 7; then the same for lines 8 to 15; and 
again for lines 16 to 23, The upshot of all this is that if you re used to a computer that uses PEEK and 
POKE on the screen, then you’ll have tc start using SCREENS and PRINT AT instead (or 
PLOTandPOINT) 

The attributes are the colours and so on for each character position, using the format of A T T R These 
are stored line byline in the order you'd expect 

The way that the computer organises its affairs changes slightly between 48 BASIC and +3 BASIC 
mode. The area that was the printer buffer in 48 BASIC mode, is used for extra system variables in +3 
BASIC mode m much the same way as it was on the Spectrum +2 The variables have changed 
though. 
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BASIC memory map 


184 



The system variables contain various pieces of information that tell the computer what sort of state it's 
in. They are listed fully in part 25 of this chapter, but for the moment, note that there are some (called 
CHANS, PROG. VARS. E LINE, and so on) that contain the addresses ot the boundaries between the 
various areas m memory These are not BASIC variables, and their names will not be recognised by 
the +3 

The channel information contains information about the input and output devices, namely the 
Keyboard (together with the tower half of the screen), the upper half of the screen, and the printer. 

Each line of BASIC program has the form 

Most significant byte 
I Least significant byte 


i 


— 1 — 

2 bytes 

1 

2 bytes 


11 n m 

00001101 

1111111 

i II 

1_11_1 

-1- 

Line 

l 

Length of 

-1 

Text 

1 

ENTER 

number 

text + ENTER 



Note that, in .contrast with all other cases of two byte numbets it: the Z80 the line number here is 
stored with its most significant byte first, le in rhe order that you a write them down 

A numerical constant in the program is followed by its binary form, using the character C H R $ 14 
followed by five bytes for the number itself. 

The variables have different formats according to their different natures. The etters in the names 
shouidbe imagined as starting off in lower case 

Number whose name is one lettei only 


Sign bit 

i 


TIT 

TTTT 


0 1 1 

_LLL 

LLLL 

Exponent byte 


4 Mantissa bytes 


L 


J L 


m 
Letter-60h 


I 

Value 
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Number whose name is longer than one letter 


D9H 


u 


y 

5 bytes 

nm 

HI* 

1ml 





Letter-60h 2nd character Last character Value 


Array of numbers 


Ullllll 

KIRHIlil 

2byies 

1 byte 

2 bytes 


2 bytes 

5 bytes each 

i i 

i 1 

1 1 

i i 


1_1 1_1 

i 

Letter-60h 

l 

Total 
length of 

1 

No, of 
dtms 

1 

1st aim 


1 

Last dim 

I 

Elements 


elements& 
dims + 1 tor no 
of dimensions 


The order of the element is 

First - the elements for which the first subscript is 1 
Next - the elements foT which the first subscript is 2. 

Next - the elements for which the first subscript is 3 
. .and so on for all possible values of the first subscript. 

The elements with a given first subscript are ordered in the same way using the second subscript, and 
so on down to the last 

As an example, the elements of the 3 x 6 array c in part 12 of this chapter are stored in the order 

c(1,1) 0 ( 1 , 2 ) c(1,3) c (1,4) c (1,5) c(1,6) and 
c (2,1) c(2,2) c(2,6)andc(3,1) c<3,2) c(3,6) 


186 










Control variable ofaFOR NEXT loop. 


Least significant byte Most significant byte 


i i 

I 


TTTTTTT 

1 1 i 

1 II 1 1 1 1 

5 bytes 

5 bytes 

5 bytes 

— i — 

2 bytes 

1 

1 byte 

i i 

l _11_1 

1 i 

i t 

1 l 

1 

Letter-60h 

- 1 

Value 

-T 

Limit 

f 

Step 

1 

Looping 

line 

i 

Statement 

number 


within line 


String. 


TTTTTTT 

0 1 0 

2 bytes 


.1.IL1LLL 




Letter-60h Number of Text of string (may be empty) 
characiers 


Array of characters 


■■■■■■■■ 

2 bytes 

1 byle 

2 bytes 


2 bytes 

i byte each 


MM 


MM 


t i 

i 1 

i 

Letter-60h 

i 

Total 
length of 

i 

No of 
dims 

i 

1st dim. 


1 

Last dim 

1 

Elements 


elements 6 
dims + l for no 
of dimensions 


The calculator is the part of the BASIC system that deais with arithmetic, and the numbers on which it 
is operating are held mostly In the calculator stack. 
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The spare area contains the space so far nnused 

The machine stack is the stack used by the Z80 processor to hold return addresses and so on. 

The GO SUB stack was mennoned in part 5 of this chapter 

The byte pointed to by RAMTOP has the highest address used by the BASIC system. Even NEW 
which clears the R AM, only does so as far as this - so it aoesn t change the user-defined graphics You 
can change the address RAMTOP by putting a number m a C L E A R statement, le. 

CLEAR new RAMTOP 

which does the following 

I Clears out all the variables 

2. Clears the display file (like C L S does) 

3 Resetsthe PLOT position to the bottom lefr-hand corner 

4 RE STOREsthe DAT A pointer 

5 Clears the GO SUB stackand puts it e.t the new RAMTOP (assuming that this lies between 
the calculator and the physical end of RAM. otherwise it leaves RAMTOP where it was) 

RUN also performs a C L E A R although it never changes RAMTOP 

Using C L E A R m this way, you can either move RAMTOP up to make more room for the BASIC by 
overwriting the user defined graphics, cr you can move it down to make more R AM that is preserved 
from NEW ft can also be used to ensure that the machine stack is below BFECh (49120) when 
intending to call +3DOS - this means that the stack will not have to be subsequemly moved within youi 
own machine code 

If you are in an expenmenra: frame of mind you car. also use C LE A R to explore the extra memory 
CLEAR 49151 moves all of BASIC be. w the redresses that hold the switchabie RAM paging 
By using POKE 23388, 16+n •>. here n is a number between. 0 and 7. you car. make Hie computer 
switch in page n of ihe RAM You will then be able to use PEEK and POKE m the normal way tc 
examine and change the page Beware - the extra pages are normally used by the system tor disk and 
editor operations, so always reset the +3 afterexplonngmthisway, before doing anything else 

Type NEW. select +3 BASIC then enter the command CLEAR 23825 tc get some idea of 
what happens to the machine when it fills up. 

If you then try to make the- +3 compute, (for example, type m PR I NT 1 + 1) you will see the 
report 4 Out of memory displayed This means the computer has nc mote room for 
information If you come up against this message while entering a large program, you will have to 
empty Ihe memory slightly (delete aline or so) inorder toocntrol the computer 
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Memory management 

We mentioned earlier that there is rather more memory in the- computer than the processor can deal 
with. While the processor can indeed address only 64K of memory at once the extra memory can be 
slotted in and out of that 64K at will. Consider a TV set. Although it (and you) can only deal with one 
channel at a time, there are another three channels always there which can be selected with the right 
buttons So, even though there's four times as much information as you can use at any one time, you can 
pick and choose which part is relevant 

It is much the same for the processor. By setting the nght bits in an I/O port it can pick and choose 
which chunks of the 192K. of memory it wants to use, For the majority of the time in BASIC it ignores 
most of the memory but for games playing, having three times as much RAM is really rather useful, 
Look again at the +3 's memory map (shown at the beginning of this section) RAM pages 2 and 5 are 
always m the positions shown when BASIC is used, though theies no reason why they shouldn't be in 
the banked section (COOOh to FFFFh) - howevet, it would be difficult to see any use for this 

The RAM banks are of two types RAM pages 4 to 7 which are contended (meaning that they share 
time ’With the video circuitry), and RAM pages 0 to 3 which are uncontended (where the processor has 
exclusive use) Any machine code which has critical timing loops (such as music or communications 
programs) should keep all such routines in the uncontended banks For example, executing NOPs in 
contended RAM will give an effeenve clock frequency of 2.66MHz as opposed to the normal 3 SSMHz 
in uncontended RAM This is a reduction in speed of about 25% 

The hardware switch normally used to select RAM is at I'O address 7FFDh (32765), The bit field for 
thisaddress is as follows 

D0.D2 -RAM select 

D3 -Screen select 

D4 - ROM select 

D5 -Disable paging 

D2- DO is a three bit number that selects which RAM page goes into the COOOh to FFFFh slot. In 
BASIC, RAMpagePis-normallymstu. When editing or calling 4-3DOS routines RAM page 7 is used 
for various buffers ana scratchpads' D3 switches screens, screen 0 is held in RAM page 5 (normally 
beginning a* 4000h) and is the one that BASIC uses Screen i is held in RAM 7 (beginning at COOOh) 
and can only be used by machine code programs It is entirely feasible to set up a screen m RAM 7 
and then page it cut. this leaves ihe entire 48K free for data ana program. Note that the + 3 s C 0 P Y 
(file) command may well use buffers in the second screen area (corrupting a second screen which 
may be hidden there) D4 determines which ROM is paged into OOOOhto 3FFFh (in combination with 
bit 2 of port SFFDh - see below) D5 is a safety feature - once this bit has been set, no further paging 
operahons will work. This is normally used when the the machine assumes a standard 48K Spectrum 
configuration and all the memory paging circuitry is locked out It cannot be turned back into a 128K 
machine other that, by switching off or pressing the RESET button, however the sound chip car. still 
be driven by 0 U T If a 48K Spectrum game loaded from disk will not work, it is possible that by using 
the SPECTRUM command followed by OUT 32765,48 (which locks bit 5 m this port) the 
game might then wot k 
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The +3 also uses I/O port I rfDh for some ROM and RA M switchmq. The bit field for this address is 
as follows: 

DO D1 -ROM/RAM switching 

D2 • Affects whether DO ,.D1 work on RAM/ROM 

D3 -Disk motor 

D4 -Parallel port strobe (active low) 

When bit 0 is 0. bit 1 has no effect and bit 2 is a 'vertical' ROM switch (ie. between ROM 0 and ROM 2 
or between ROM 1 and ROM 3). Bit 4 in the port at 7FFDh is a 'horizontal ROM switch (ie. between 
ROM 0 and ROM 1, or between ROM 2 and ROM 3) The following diagram serves to show the various 
ROM switching possibilities 


ROM 0 

Bit 4 7FFDh (23388) 
(system variable: BANKM) 

ROM 1 

Editor 

«— horizontal —» 

Syntax 


Bit 2 IFFDh (23399) 

(system variable: BANK678) 

vertical vertical 


ROM 2 
DOS 


horizontal 


i 

ROM 3 
48 BASIC 


Horizontal and vertical ROM switching 


It is best to think of bit 4 in port 7FFDh andbit2m port IFFDh combining to form a 2 bit number (0,3) 
which determines which ROM occupies the memory area OOOOh 3FFFh Bit 4 ol port 7FFDh is the 
least significant bit and bit 2 of IFFDh is the most significant bit 
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Bit 2 of IFFDh 

(System variable: BANK678) 

Bit 4 of 7FFDh 
(System variable: BANKM) 

Switched ROM at OOOOh...3FFFh 

0 

0 

0 

0 

1 

1 

1 

0 

2 

l 

1 

3 


ROM switching (with Bit 0 of 1 FFDh set to 0) 

When bit 0 of port i FFDh is set to J. bits 1 and 2 switch in various RAM combinations that occupy the 
full 64K address space These are not used by +3 BASIC but are provided for authors of operating 
systems/games. When the +3DOS 'DOS BOOT routine is used, the bootstrap is loaded into the 4,7, 6. 
3 RAM page environment Thevanous +3 extra RAM paging options are as follows 


Bit 2 of IFFDh 

Bit 1 of IFFDh 

RAM pages used 

(0000h...3FFFh, 4000h...7FFFh, etc.) 

0 

0 

0,12,3 

0 

1 

4,5,6.7 

1 

0 

4,5,6,3 

1 

1 

4,7.6,3 


Extended memory paging (with Bit 0 of 1 FFDh set to: i 
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Part 25 

The system variables 

Subjects covered... 

POKE,PEEK 


The bytes in memory from SBOOh (23296) to 5CB6h (23734) are set aside for specific uses by the 
system. There are a few routines fused to keep the paging m order) and some locations called system 
variables You can peek these to find out various things about the system, and some of them can be 
usefully poked. They are listed here with their uses, 

There is quite a difference, as you might expect, between the system variables area in 48 BASIC 
mode and in +3 BASIC mode. In 48 BASIC mode, all the variables and routines below SCOOh (23552) 
do not exist; instead there is a buffer between SBOOh (23296) and SCOOh (23552) which is used for 
controlling the printer This was quite a popular location for small machine code routines on the old 
48K Spectrum, and if any of these routines are tried m + 3 BASIC mode, the computer will invariably 
crash Any old program that uses PEEK POKE and USR is therefore a safer bet if it is run in 48 
BASIC mode (although it can be entered in +3 BASIC mode ana transferred using the 
SPECTRUM command). If there is a chance that a program might inadvertently address the added 
I/O ports of the -f 3, then OUT 3 2 7 6 5,4 8 will set bit 5 m port 7FFDh to disable further use of the 
added ROM/RAM switching. 

Although system variables have names, you should not confuse them with the words and names used 
in BASIC. The computer will not recognise the names as referring to system variables, they are given 
solely as mnemonics for we humans. 

The abbreviations in column 1 of the table ahead have the following meanings 
X - The variables should not be poked because the system might crash 
N - Poking the variables will have no lasting effect, 

R • Routine entry point. Not a variable 

The number m column 1 is the number of bytes in the variable or routine For a two-byte word, the first 
byte is the least significant - the reverse of what you might expect. So, to poke a value v into a two-byte 
vanable at address n use.. 

POKE n,v-256* INT (v/256) 

POKE n+1, INT (v/256) 

., and to peek its value, use the expression. 

PRINT PEEK n+256* PEEK (n+1) 


192 




NOTES 

ADDRESS HEX 
(DECIMAL) 

NAME 

CONTENTS 

RI6 

5B00h(23296) 

SWAP 

Paging subroutine 

R17 

SBlOh (23312) 

STOO 

Paging subroutine. Entered wirn interrupts 
already disabled and AT, BContlie stack 

R9 

5B21h(23329) 

YOUNGER 

Paging subroutine 

R16 

5B2 Ah (23338) 

REGNUOY 

Paging subroutine 

R24 

5B3Ah (23354) 

ONERR 

Paging subroutine. 

X2 

5B52h (23378) 

OLDHL 

Temporary legister store while switching 
ROMs. 

X2 

5B54h (23380) 

OLDBC 

Temporary legister store while switching 
ROMs 

X2 

SB56h (233821 

OLDAF 

Temporary register store while switching 
ROMs 

N2 

5B58h(23384) 

TARGET 

Subroutine address in ROM 3 

X2 

5B5Ah (23386) 

RETADDR 

Return address m ROM 1. 

XI 

5B5Ch (23388) 

BANKM 

Copy o! last byte output to I/O port 7FFDh 
(32765), This port is used to control the RAM 
paging (bits 0 .2) the 'horizontal’ ROM 
switch (0<—*1 and 2«—>3 - bit 4), screen 
selection (bit 3) and added I/O disabling 
(bit 5). This byte must be kept up to date 
with the last value output to the port if 
interrupts are enabled. 

XI 

5B5Dh (23389) 

RAMRST 

RST 8 instruction. Used by ROM 1 to report 
old errors to ROM 3. 

Nl 

5B5Eh (23390) 

RAMERR 

Error number passed from ROM 1 to ROM 
3 Also used by SAVE/LOAD as 
temporary drive store 

2 

SBSFh (23391) 

BAUD 

RS232 bit period m T states/26, Set by 

FORMAT LINE 

N2 

5B61h(23393) 

SERFL 

Second-character-received-flag, and data. 

Nl 

5B63h(23393) 

COL 

Current column from 1 to width. 

1 

5B64h(23396) 

WIDTH 

Paper column width, Defaults to 80, 

1 

5B65h(23397) 

TVPARS 

Number of mime parameters expected by 
RS232 

1 

5B66h (23398) 

FLAGS3 

Various flags Bits 0, 1.6 and 7 unlikely to be 
useful. Bit 2 is set when tokens are to be 
expanded on printing. Bit 3 is set if print 
output ts RS232. The default (at reset) is 
Centronics Bit 4 is set if a disk interface is 
present. Bit 5 is set if dnve B ispresent. 
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NOTES 

ADDRESS HEX 
(DECIMAL) 

NAME 

CONTENTS 

XI 

5B67h(23399) 

BANK678 

Copy of last byte output tc 10 port lFFDh 
(8189) This port is used to control the A3 
extended RAM arid ROM switching (bits 
0 2 if bit 0 is 0 then bn 2 controls the 
'vertical ROM switch 0«—»2 and i< — «3), 
the dis.< motor (bit 3) and Centronics strobe- 
tbit 4) This byte must be .<ept up to date 
with the last value output to the port if 
interrupts are enabled 

N) 

3B68h (23400) 

XI,oc 

Holds X location when using the 
unexpanded COPY command 

Ni 

5B69h (2340:j 

YI.OC 

Holds Y location when using the 
unpxpandect COPY o mrumd 

X2 

5B6A1. (P.34Q2) 

OLDSP 

Old SP (slack pointer) wh-vn TSTACK \r. 
use 

X2 

SB6Ch (23404) 

SYNRFT 

Return address for ONERR 

5 

5B6t'h (23406) 

LASTV 

Last value printed by calculator 

2 

5B73h(234l 1) 

RCLINF 

Current line being renumbered 

2 

5B75h (234L3) 

RCSTART 

Rtarnr.q line number for renumbering. The 
default value is 10. 

2 

5R 77h (23415) 

RC STEP 

Incremental value for renumbering The 
default is 10, 

1 

5B79h (23417) 

LODDRV 

Holds T if LOAD VERIFY MERGE are 

fmmt ; > therwise holds A B iM 

1 

5B7 Ah (23418) 

SAVDRV 

HcI j T if SAVE is ‘ tape otherwise holgn 

A BorM 

J 

NB 

8B7Bh(234l3) 

DUMPI,r 

Hr ads the number of 1 216l)is used for him 

R ■ is m COPY EXP ITus is norma.iy ' 
ir 7 If problems are experienced fitting ■ < 
dump ante sheet : A4 paper POKE this 
location with 6. This will reduce the size of 
the dump and improve the -aspect ratio 
slightly (The quality oi the dump will be 
marginally degraded, howevet 

5B7Ch(23420j 

STRIP! 

Stripe one bitmap 

MB 

5B84h(23428) 

STR1P2 

Stnuc two bitmap This extends t: iBBfcl, 
{23436;. 

XI IS 

5Brrh(235SI) 

TSTACK 

Tempemry stace grows rl, wn from hr re 
Used whe r l-.AM pace , is switched m at 
top . t memory (while executing the editor 
r c B+3DOS ' 1 town 

5B8Ch (and across STRIP! and STRIP? it 
necessary) Thus guarantees at least l! ; 
bytes of stack when BASIC calls +3DOS 
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ADDRESS HEX 

NOTES (DECIMAL) NAME CONTENTS 


N8 

SCOOh (23552) 

KSTATE 

N! 

3C08h (23560) 

LAST K 

I 

5C091i (23561) 

REPDEL 

| 

5CCAh (23562) 

REPPER 

N2 

5C0Bh (23563) 

DEFADD 

N! 

SCODh (23565) 

KDATA 

N2 

SCOEh (23566) 

TVDATA 

X38 

5ClCh (23568) 

STRMS 

2 

5C36hi 23606) 

CHARS 


l 

5C38h (23606) 

RASP 

1 

5C3Sh (23609) 

PIP 

1 

5C3Ah (23610) 

ERR NR 

XI 

SC3Bh (23611) 

FLAGS 

XI 

5G3Ch(236)2) 

TV FLAG 

X2 

5C3Dh (23613) 

ERRSP 

N2 

5C3Fh(23s!5) 

LtSTSP 

N1 

S041h(23617) 

MODE 

2 

5C42h(23618) 

NEWPPC 

1 

5C44h (23620) 

NSPPC 


?. 

5C4Sh (23621) 

PPC 

1 

SC47h (23623) 

SUBPPC 


5C48h (23624) 

BORDCP 

rj 

SC49h (23625) 

EPPC 


Used in reading the keyboard 
Stores newly pressed key 
Time (in SOths of a second) that a key must 
be- held down before it repeats. This starts 
off at 35 but you can P 0 K E in other vatues 
Delay (m 50ths of a second) between 
successive repeats of a key held down 
-inittally 5 

Acdress ot arguments of user defined function 
i if one is being evaluated), otherwise 0, 

Stores 2nd byte of colour contiols entered 
rrom keyboard. 

Stares bytes of colour A T and TAB 
controlsgomgtoTV. 

Addresses of channels a ttached to streams 
256 less thaD address of character set 
(which staits with space and carries on (< • 
c) Normally in ROM. but you can set up 
your own in RAM and make CHARS point to 
it. 

Length of warning buzz 
Length of keyboard click 
l less than the report code Starts off at 2S5 
' ’ ■ PEEK 2 36 1 0 gives255 

Various flags to control the BASIC system 
Flags associated with the TV 
Address of item on machine stack to be 
used as error return 

Address of return address from automatic 
listing. 

Specifies K L C E or G cursor 
Line to be jumped to 

Statement number in line to be jumped to 
Poking fust NEWPPC and then NSPPC 
forces a jump to a specified statement m a 
line. 

Line number of statement currently being 
executed 

Number within line of statement being 
executed. 

Border coiout multiplied by 8, also contains 
the attributes normally r ad for the lower 
half of the screen. 

Nutr.bet of current line (with program 
cursor), 
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ADDRESS HEX 

NOTES (DECIMAL) NAME CONTENTS 


X2 

5C4Bh (23627) 

VARS 

N2 

5C4Dh (23629) 

DEST 

X2 

5C4Fh (23631) 

CHANS 

X2 

5C51h (23633) 

CURCHL 

X2 

5C53h (2363S) 

PROG 

X2 

5CS5h (23637) 

NXTLIN 

X2 

5C57h (23639) 

DATADD 

X2 

5C59h (23641) 

EL1NE 

2 

5C5Bh (23643) 

KCUR 

X2 

SCSDh (23645) 

CHADD 


2 

5C5Fh (23647) 

XPTR 

X2 

5C6lh (23649) 

WORKSP 

X2 

5C63h (23651) 

STKBOT 

X2 

5C65h (23653) 

STKEND 

N1 

SC67h (23655) 

BREG 

N2 

5C68h (23656) 

MEM 

1 

3C6Ah (23658) 

FLACS2 

XI 

5C6Bh (23659) 

DFSZ 

2 

5C6Ch (23660) 

STOP 

2 

5C6Eh (23662) 

OLDPPC 

I 

5C70h (23664) 

OSPCC 

N1 

5C71h (23665) 

FLAGX 

N2 

5CZ2h (23666) 

STRLEN 

N2 

5C74h (23668) 

TADDR 

2 

5C76h (23670) 

SEED 

3 

5C78h (23672) 

FRAMES 

2 

5C7Bh (23675) 

UDG 


Address ofvariables 
Address of variable m assignment, 

Address of channel data 

Address of information currently being 

used for input and output 

Address of BASIC program, 

Address of next line m program 
Address of terminator of last DATA item 
Address of command being typed in. 
Address of cursor 

Address of the next character to be 
interpreted - the character after the 
argument of P E E K, or the NEWLINE at the 
end of a P 0 K E statement 
Address of the character after the | 
marker. 

Address of temporary work space 
Address of bottom of calculator stack 
Address of start of spare space. 

Calculator's B register 

Address of area used for calculators 

memory (usually MEMBOT, but not 

always) 

More flags. (Bit 3 set when CAPS SHIFT or 
CAPS LOCK is on) 

The number of lines (including one blank 
line) m the lower part of the screen, 

The number of the top program line m 
automatic listings 

Line number to which CONTINUE 
tumps. 

Number within line of statement to which 

CONTINUEjumps 

Various flags 

Length of string type destination in 
assignment 

Address of next item in syntax table (very 
unlikely to be useful) 

The seed for R N D, This is the variable that 
is set by RANDOMIZE 
3 byte (least significant byte first), frame 
counter incremented every 20rnS. 

Address of first user-defined graphic. You 
can change this, for instance, to save space 
by having fewer user-defined graphics. 
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NOTES 

ADDRESS HEX 
(DECIMAL) 

NAME 

CONTENTS 

1 

SC7Dh (23672) 

COORDS 

X-coordmate of last point plotted, 

1 

5C7Eh (23678) 


Y-coordinate of last point plotted, 

1 

5C7Fh (23679) 

PPOSN 

33-column number of printer position. 

1 

5C80h (23680) 

PRCC 

Least significant byte of address of next 
position for L P RIN T to print at (in printer 
buffer), 

1 

5C81h (23681) 


Not used. 

2 

5C82h (23682) 

ECHOE 

33-column number and 24-line number (m 
lower haff) of end of input buffer 

2 

5C84h (23684) 

DFCC 

Address in display file of P RIN T position. 

2 

5C86h (23686) 

DFCCL 

Like DF CC foi lower part of screen, 

XI 

5C38h (23688) 

SPOSN 

33-column number for P RIN T position, 

XI 

5C89h (23689) 


24-lme number for P RIN T position. 

X2 

5C8 Ah (23690) 

SPOSNI. 

Like S POSN for lower part. 

1 

5C8Ch (23692) 

SCR CT 

Counts scrolls - it is always 1 more than the 
number of scrolls that will be done before 
stopping with scroll? If you keep 
poking this with a number bigger than 1 
(say 255). the screen will scroll on and on 
without asking you 

1 

SC8Dh (23693) 

ATTRP 

Permanent current colours, etc., (as set up 
by colour statements) 

1 

5C8Eh (23694) 

MASKP 

Used for transparent colours etc. Any bit 
that is 1 shows that the corresponding 
attribute bit is taken not from ATTR P, but 
from what is already on the screen. 

N1 

5C8Fh (23695) 

ATTRT 

Temporary current colours, etc., (as set up 
by colour items). 

N1 

5C90h (23696) 

MASKT 

Like MASK P, but temporary. 

1 

5C9ih (23697) 

PFLAG 

More flags 

N30 

SC92h (23698) 

MEMBOT 

Calculator's memory area - used to store 
numbers that cannot conveniently be put on 
the calculator stack. 

2 

SCBOh (23728) 

NMIADD 

Holds the address of the users NMI service 
routine 

NOTE - On previous machmes, this did not 
work correctly and these two bytes were 
documented as 'Not used. 1 Programs that 
used these two bytes for passing values 
may need to be modified 

2 

5CB2h (23730) 

RAMTOP 

Address of last byte of BASIC system area. 

2 

SCB4h (23732) 

PRAMT 

Address of last byte ofpnysical RAM 
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Part 26 

Using machine code 

Subjects covered... 

U S R with numeric argument 

This section is written for those who understand Z80 machine code it-, the set ot instructions that the 
Z80 processor chip uses If you do not, but would like to. there are plenty of books about it. You should 
get one called something along the lines of Z80 machine code (or assembly language) tor the 
absolute beginner and if it mentions the +3 or other computers ir. the ZX Spectrum range so much 
the better 

Machine code programs are normally writte n in assembly language which althc jgh cryptic, is nol 
too difficult to understand with practice. You can see the assembly language instructions in part 28 ot 
this chapter However to run them on the +3 you need to code the program into a sequence of bytes 
-then called machine code This translation is usually done by the computer itself using a program 
called an assembler There is r.c assembler built in r i the +3 but you will be able to buy one on disk 
or tape Failing that, you will have to do the translation yourself, provided that the program is not too 
long 

Let s take as a n example the program. 

Id be, 99 
ret 

which loads the BC register pair with 99 This translates into the tour machine code bytes i, 99.0 (for 
Id be, 99) and 201 (for ret) (If you look up codes 1 and 201 in pari 28 of this chapter, you will 
find that, cor responds to fd be, AW where NN stands for any two-byte number and 201 corresponds 
to ref) 

When you have got your machine code program the next step is to get it into the computer - (an 
assembler would probably do this automatically) You need to decide whereabouts in memory to 
locate it - the best thing is to make extra space for it between the BASIC area and the user defined 
graphics. 

If you type 

CLEAR 65267 

this will give you a space of 100 (for good measure < bytes starting at address 6S268 

To put in the machine code program, you would run a BASIC program something like 

10 LET a=65268 
20 READ n: POKE a,rt 
30 LET a=a+1: GO TO 20 
40 DATA 1,99,0,201 

(This will stop with the report E Out of DATA when, it tras filled in the four bytes you specified..- 
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: o run the machine e ae. you use the function U S R - but this time with a numeric argument, le the 
starting address. Its result is the value of the BC register on return from the machine code proqtam so 
if you type 

PRINT USR 65268 

you will get the answer 99 

The return address tc BASIC is stacked tr. the usual way so return is by a Z8Q ret instruction You 
should not use the IY and I registers m a machine code routine that expects to use the BASIC interrupt 
mechanism If you ate writing a program that might eventually run on an older Spectrum (up to and 
including the +2 1 . y-u should not load I with values between 40h and 7Fh (even if you never use !M 
2) Values between COh and FFh for I should also be avoided if contended memory (te RAM 4 to 7) is 
to be paged in between COOOh and FFFFh This is due to an interaction between the video controller 
'■tid the Z80 refresh mechanism, and can cause otherwise inexplicable crashes, screen corruption or 
other undesirable effects. Thus, you should only vector IM 2 interrupts to between 8000h and BFFFh 
unless you are very confident of your memory mapping (or you are only going to tun your program on 
the +3 where this problem does not east) 

The system variable at SCBCh (23728) was documented on previous models o! the Spectrum as 
Not used It is new used in the +3 as an NMI jump vector If an NMI occurs, this address is 
checked If it contains 0, then no action is taken However, fot any other (non-aero) value, a lump will 
be made to the address given by this variable NMIs must not occur while the disk system is active 

There are a number of standard pitfalls wher. programming a banked system such as the +3 from 
machine code. If you are experiencing problems, check that your stack is not being paged out dunng 
interrupts, and that your interrupt routine is always where you expect it to be (it is advisable to disable 
interrupts during paging operanons). ltis also recommended that you keep a copy ol the current bank 
tentster setting in unpaged RAM somewhere as the ports sit wrile-only BASIC and the editor use the 
system variables BANKM and BANKS78 for 7FFDh and I FFDhrespectively 

I: you cb . 4-3DOS routines remember that interrupts should be enabled upon entry to the routines 
Remember also that the stack must be below BFEOh (.49120) and above 4000h (16384). and that then 
must be at least So wotds of stack space available 

Y< ■ u can save your machine code program easily enough with (for example i 

SAVE "name" CODE 65268,4 

On the face of it there is no way of saving the program so thdt when ioaden it automatically runs Use)! 
however you can get round this by using the short BASIC progian 

10 LOAD "name" CODE 65268,4 
20 PRINT USR 65268 

which should also be saveci (asa separate progtarn) usina the i ■ ■ tr.mand (fot example 

SAVE "Loader" LINE 10 
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Then you may rur. the machine code from BASIC using the single command, 

LOAD "Loader" 

which loads and automatically runs the BASIC program which in turn loads ana runs the machine 
code 


Calling +3DOS from BASIC 


When BASIC'S IISR function is used, the code it references is entered with the memory configured as 
illustrated below (left), le, the ROM switched in at the bottom of memory m the address range 
(OQOOh, SFFFh) is ROM 3 (the 48 BASIC ROM). The RAM page at the top of memory is page 0 and the 
machine stack resides in this area (unless the CLEAR command has been used to reduce it to 
somewhere below COOOh) As explained m part 27 of this chapter (which describes the +3DOS 
routines), DOS can only be called with RAM page 7 switched in at the top of memory, the stack held 
somewhere in the range 4000h BFEOh and ROM 2 (the DOS ROM) switched in at the bottom of 
memory (OOOOh. 3FFFh). This configuration ts illustrated below (right) 


In BASIC 

(after U SR) (using DOS) 


COOOh 

8000h 

4000h 

OOOOh 


Page 0 

*- SP 

COOOh 

Page 7 



Page 2 

8000h 

Page 2 



Page 5 

4000h 

Page 5 



ROM 3 

OOOOh 

ROM 2 


SP 


Consequently it will be necessary to switch both ROM and RAM. and move the stack before and altei 
calling one of the entries ui the DOS jump table The following very simple example shows one way of 
achieving the desired set up m order to cal! DOSCATALOG 

11 BASIC -CLEAR command has been used so that the BASIC stack is below BTEOh (49 i20), then it if 
not necessary to move the stack. However, we have done so in the following example to demonstrate 
the technique when this is not the case 
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A simple example to call DOS CATALOG 


org 

7000n 





mystak 

equ 

9F FFh 

;artntrary value picked to be below BFEBr 

and above 

4000k 

s'aksio 

equ 

9000n 

;somewhere to put BASIC's stack pointer 



bank* 

equ 

5B5CH 

;systea variable that holds the last value 

output to 

7FFD1. 

port t 

equ 

7Ff0h 

;aadress of ROM/RAM switching port in I/O 

map 


catbu'! 

equ 

6000n 

;somewhere for DOS to put its catalog 



dos catalog 

equ 

enth 

;the DOS routine to call 




demo: 


di ;unwise to switch RAM/ROM without disabling interrupts 

Id (s:aksto),$p ;save BASIC's stack pointer 

id be,port! j the horizontal ROM switch/RAM switch I/O address 

Id a,(banKm) ;system variable that holds current switch state 

res A,a ;move right to left in horizontal ROM switch (3 to 2) 

or 7 ;switch in RAM page 7 

Id (bankm),a ;»ust keep system variable up to oate (very important) 

out (c),a ;make the switch 

Id sp,mystik ;make sure stack is above 4000n and below BFt0n 

e» ;interrupts can now be enaoieo 


i 

; the above will nave switched in the DOS ROM ano RAM page 7. The stack ras also been 
; located in a "safe” position tor calling DOS 

i The following i» the code to set up and call DOS CAIALOG. this is where your ow* 

; code woulo be placed. 


Id 

bi/Catbuff 

;somewhe'-e for D0$ to put tne catalog 

Id 

de,catbuf f ■* 1 

Id 

be,1024 

;waM«um is actually 64x 13 + 13 _ 845 

Id 

(hl),0 

lOl r 


;aake su'e at least first entry ,* zer&ised 

Id 

b,64 

;the number of entries m the buffe* 

(a 

c, 1 

;inctude system files in the catalog 

Id 

ae,cdtbuf f 

;the tocaf'on to be filled with ihe bisk catalog 

id 

hl,stardslar 

;the file name (*•.*"> 

cal l 

dos catalog 

;cai i me DOS entry 

push 

a* 

;save flags and possible error number returned by DOS 

pop 

hi 


id 

(oosret J,hi 

;put -l whefe it can be seen from BASIC 

Id 

t ,b 

;wove number of files in catalog to low byte of BC 

Id 

b/0 

;this will be returned in BASIC by the USR function 


It the above worueo, men BC nolds nj«ber of files in catalog, the "catbuff” will 
be fiiieo v t h tne a lpnanume r i ca l ly so r ted catalog ano the carry flag bit in "dosret" 
will be set. This w'll be peeked from BASIC to check if all went well. 

Hau'ng »ace the call to DOS, it is now necessary to undo the ROM and RAM switch and 
put BASIC's stac* back to where it was or entry, The follow pg will achieve this. 


201 






di 


;adout to ROM/RAW switch so be careful 

push 

be 

;save number of files 

Id 

bc,port1 

; 1 /0 address Of horizontal ROM/RAM sw’tch 

Id 

a, (bank m) 

;ge! current switch stale 

set 

4 y a 

;move left to right (ROM 2 to ROM 3) 

and 

F8h 

;also want RAM page 0 

Id 

<ba"km) ,a 

;update the system variable (very important) 

out 

< c),a 

;ma*e the switch 

pop 

be 

,-get back the saved number of files in catalog 

Id 

sp,< stiksio) 

;pui BASIC's stack cac« 

ret 


;returr to BASIC, value in BC is returned to (j$R 

stardsiar: 

defb 

"*.,Ff 1 

; the *ile name, must be termi«dte3 *ilh Ffh 

doaret 

defw 

0 

;a variable to be peeked f rom BASIC to see if ; t worked 


As some of you may not have an assembler available the following is a BASIC program »hat pokes tha 
above code into memory, calls it, and then uses the value returned by the USR function and th. 
contents of dosret to print a very simple ca’u log of the disk 

10 LET sum = 0 

20 FOR i=28672 TO 28758 

30 READ n 

40 POKE i,n : LET sum=sum+n 
50 NEXT i 

60 IF sum <> 9387 THEN PRINT " 

Error in DATA" : STOP 
70 LET x=USR 28672 
80 IF INT ( PEEK (28757)/2)= P 
EEK < 28757)/2 THEN PRINT "D 
isk error PEEK (28758): 

STOP 

90 IF x = 1 THEN PRINT "No files 
found": STOP 
100 FOR i=0 TO x-2 
110 FOR j=0 TO 10 
120 PRINT CHRS ( PEEK (32781+i* 

13+j>>; 

130 NEXT j 
140 PRINT 
150 NEXT i 

160 DATA 243,237,115,0/144,1,25 

3,127,58,92,91,203,167,246, 
7,50,92,91,237,121,49,255,1 
59,251 
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170 DATA 33,0,128,17,1,128,1,0, 
4,54,0,237,176,6,64,14,1,17 
,0,128,33,81,112,205,30,1,2 
45,225,34,85,112,72,6,0 
180 DATA 243,197,1,253,127,58,9 
2,91,203,231,230,248,50,92, 
91,237,121,193,237,123,0,14 
4,201 

190 DATA 42,46,42,255,0,0 


The addresses picked ioi the above code and us data areas are completely arbitrary however, it is a 
good idea to keep things in the central 32K wherever possible so as not to run into th< ■ pitfall of 
accidentally switching out a vita! variable or piece of code 

11 interrupts are to be enabled fas is the case m the above example) it is imperative that the system is 
kept up tc date about the latest ROM switch This means that the user must make the BANK678 system 
variable reflect the last value output to the port at I FFDh Asshown by the above example the genera! 
technique is to take a copy of the variable in A set reset the relevant bits update the system variable 
then make the switch with an 0 U T instruction Interrupts must be disabled while the system variable 
does not reflect (he current state of the pert The port at 1 FFDh doesn't just control the ROM switch sc 
setting the variable to absolute values would be very unwise Using AND-OR with a bit mask • r 
SET RES instructions is the preferred method of updating the variable, 

]ustas BANK678 reflects the last vaiue output to IFFDh BANRM should also oe kept up to date with 
the last value output to 7FFDh Again it is unwise tc use absolute values as the port is used for ether 
purposes. For example the bottom 3 bits of the port are used to select the RAM page that is switched 
into the memory area COOOh TEFFh (this is also shown m the above example) Naturally when more 
than one bit is to be set/ieset. a bit mask used with GR AND is the more efficient method Not^ that 
RAM paging was described m the section entitled Memory management in part 24 of this chapter 

The above was a very simple example of calling DOS routine - The following she ws one r tw<> extra 
techniques that you may find useful. However if you are not already familiar with assembler 
programming, it might be better to skip this example 

Although part 20 of this chapter suggested that the .t c-ninci menu's Loader optnfirst .•k i 
file caF.cd * and then one called DISK before trying to .aad the first tile :r, t: tap' • this isn’t e xueily 
the whole story The first operation actually tries to load a bootstrap sector front the disk tn drive A 
The sector on side 0. track J sector 1 will be 'used as a loader (bootstrap) if the system finds that the 8 
bit checksum of the sector is 3 The following program ensures that the checksum of 51? bytes 
conforms to this requirement then writes the information to the disk m the correct position Once a 
• risk has been modified m this way, the Loader option can be used to lutomaticaliy lead md run 
the disk Alter natively, the BASIC cor: manti LOAD "*" ran be used 
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This example was developed using M80 on a CP M based machine - so the method used to ensure 
that the code is as. /mbled relative to the correct address might be different from that used by your 
own assembler 


Simple example program to write a boot sector to the disk in drive A:, 
by CliM Lawson 

COffyrighl (c) AMSTRAD Pic. 1987 


.^80 


ban* 1 

eau 

0 7F F Dr» 

bantm 

eou 

0505CH 

bank 2 

ecu 

01 f F Dh 

0an<678 

equ 

0S067H 

select 

eau 

0160th 

dos -et xopb 

equ 

0151n 

dd write 3ee tor 

equ 

0166h 

•Jd login 

eau 

0175* 


Org 0 


.phase 07000* 


;igno-e tt s t* not using M80 

;"hor1 rontai" ano RAM Sw’tC* pO r 1 
;associated system variable 
vertical" Switch port 
.'associated system variable 

;BA51C routine to open strea* 

;see pa*t ?7 o* this chapter 


; (Tnlj it m.s 

M80 to generate a 

• COM 

Tile that *a> aooresses relative lo 70fl0n. 

; Assemble with "*80 ? prog" a r a 

l ink 

with " L 80 /p:0,/fl :0,c*og,P' , cg/":p/y/e" 

; this can be 

*eacea ■i th CO PV.. 

.TO 5PECTRUM FORMAT and loaded with 

; load ... CODE 

?867?. 



; A different 

techmQje will probably 

be reputred *o* ether assemblers.) 

start: 




Id 

(olslaO ,sp 


;save BASIC** start. po»rle r 

id 

sp ,my s *. a < 


;pjt stack oelow swteneo HAM pages 

push 

i >r 


;save IT on stac* *or the moment 

Id 

a/'A" 


;d*i ve A : 

Id 

vy,dos re* «dph 


;ma*e IX point to XDPB A: (necessary for calling 

tall 

dooos 


; fouli^es) 

Id 



;log »r disk in unit 0 so that writing secto's 

OUSh 

1 > 


;wont sa> "dis* -as beer cha*gea" 

Id 

' v ,aa login 



c«u 

oodos 



pac 

i > 



lo 

n i .booisecij 



Id 

be,51? 


; qqi ng to chec«5u« 51? bytes of sector 

■i nr 

a 



la 

iboot sec tor* 15 ) ,a 


j*eset -:*ec«.sum *o* sta-«er$ 

id 

e f a 


it will note 8 b»t sum 





1 Q 




ado 

i 


; • n. 5 loop mj»e5 & D 1 c-*-*Su? ? 4 5 1 ? o*ta 

id 

e*4 


J5ect4* r £ 
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dec 

be 


id 

a,b 


Of 

c 


ir 

n* ,cUoop 


id 

a,e 

;A now has S bit checksum of Me sector 

cpl 


;ones complement ftl will give negative value) 

ado 

3/4 

;add 3 to wake sum = 3 ♦ Mo wake twos complement 

id 

<bootsecto r *15) ,a 

;w-ll wake bytes checksum to 3 mod ?S 6 

Id 

b /0 

;page 0 at C000n 

la 

c /0 

;unit 0 

id 

d /0 

;track 0 

lo 

e ,0 

;sector 1 (0 because of log • cal/physical trans.) 

id 

hl/bootse:tor 

;address of info, to write as boot sector 

id 

iy,dd write.sector 


cal l 

dodos 

;aetually write sector to disk 

pop 

* Y 

;put IY back so BASIC can reference its system variables 

id 

sp,(oIs tac) 

/•put original stack back 

ret 


;ret urn to USB call in BASIC 

dodos: 

; IY holds 

the address of the DOS routifif to be run. All othe* register* are passed 

; intact to 

the DOS routine and are 

returned from it. 

; Stack is 

somewhere in central 3?K 

(conforming to DOS reQj ■re»enttJ/ so saved AF and 

; BC will not be snicked pot. 


push 

If 


push 

be 

;temp save registers wh-ie switching 

Id 

a,(ba r kw) 

,RAM/ROM Switching s/ste* variable 

Or 

? 

;want PAH page 7 

res 

4/3 

;and 005 ROM 

id 

di 

bt /bank 1 

IPO r t used for fioru ROM switch and RAM paging 

id 

ibankmJ,a 

;keep system variables up to date 

out 

ftl 

(c),a 

;RAM page 7 to top and DOS ROM 

POD 

be 


pop 

af 


call 

jumplof» 

;go sub routine add r ess in IV 

oust) 

Jf 

;return from JP (1Y) H (| be ro here 

oust' 

be 


id 

a,(bankm) 


and 

0fBr 

;reset b»is fur cage 0 

set 

4/a 

/•switch to ROM 3 (Aij BASIC) 

id 

a\ 

be/bank 1 


id 

{ ban »*),3 


out 

el 

ic) # a 

;s*?tch bac< to RAM page 0 ang eg BASIC 

pop 

be 


pop 

ret 

§♦ 


iumpfO'T: 

ip 

tty) 

istandarfl .ay to C*U <1Y), by calling this jump 

ok stav 1 

Ute 

0 

isomewhere to pul BASIC'S stack pointed 

OS 

100 
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«iy s t a k: 
boot sector: 


;e"ough stack to meet *3D0S reaui -e*erif$ 


.depnase ;t*e$e M80 pseudo ops. >ou- assembler 

.phase 0FE00 n ;may use something different 


Bootstrap will load into page 3 at aod r ess F £00 n. Tup code hhI be ente-eo at FE10O. 

Before it is written to t r aek 0, sector 1, the bootstrap *>as b»te 15 changed so 
that it will checksum to 3 moo 256, 

Boot will switch the memory so that the 48 BASIC ROM is at the bottom. Neit op is 
page 5 me screen, then page 2, ano me r 0 p will keep page 3, as t woulo be 
unwise to Switch out the bootstrap. BASIC routiies can bp called • t* any ram 
page switched n at the top, but tre stack shouldn't be m me T5 TaCK a r ea. 


boot start: 


; The bootst 

r ap secto r cortams the 16 byte Cis* spec ■> ♦ i cat: on at the start, 

; following 

values am *o t a 

AMSTRAD PCW range CF2/Spect*um *5 *O r m-*t J;s». 

ob 

0 

;*3 format 

db 

0 

jsingle sided 

ob 

40 

;i0 t r acks cer s»de 

db 

9 

;9 sector* D e r mat* 

Ob 

l 

;log2<512>-2 - sector ;rte 

db 

t 

;1 reserved macs 

db 

3 

;blads 

db 

? 

;2 directory etoess 

db 

02 Ah 

;gap length (r/w) 

ob 

05?h 

;gap length lfornai) 

ds 

3,0 

;S reserved b>tes 

cksu*: 

db 0 

;cnec*sjm musl - 5 moa ?56 *o r me sett:* 

; the bootst 

r ap - be 

er. hem w m the 4, 7, 6 , 3 P *M pages s-itcma m. 

; To pr-.nt something, , e - eed 

48 BASK m at tre bottom, page 5 <mp semen ara 

; system «ar 

Mbles) r.e*i jp, 

the rent page will be 0 , jnc me iqc pe *ept 

; as page 3 
; on entry). 

because it s• 11 

contains the bootstrap and stack isiack is FE 00 r 

Ct 

Id 

a,(ban»mj 


and 

0F8n 


c 

3 

;BAM page 3 (35 (l mibS 0D3tS» , 3P/ 

set 

a, a 

;->g-t-harc ROMs 

Id 

be , 0 aH *1 


lo 

(banltmJ ,a 


out 

(c i, a 

;s«»vleh RAM and 10 - 1/00131 ROM 

IQ 

a,(barn 6 F 8 i 


and 

0FBh 


Oh 

4 

;set bit l anc mset b*i 0 (gi.es PQM *1 

id 

be,ban *2 


Id 

( bann 6 7 8 J,a 


out 

< c ) , a 

;s*oulo row n ds e *3,5.c,i 

id 

a ,2 


ral 1 

select 

;B A SIC ROM r fj pi. ? *••• trmam i4) 

tS 

** l ,«essage 


xaU 

print 

;pr:nt a message 
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eloop: 


; end mtn a" egoless loop c»iangi"g the borcer. Tnis is •.►ere your own cofle 
; for a game or operating system would an. 

<*/ r ;a *iot-very*random »-a«clo«i njrnber 

OtJf (8 # eM#a ;sw1tch the border 

jr eloop ;and loop 

print: 

;t h is just loops printing characters 
;until it Hnds Ffn 

,;witn ROM in, this wilt print cnar in A 


message: 

b,2 t W/7/19,0,22,10,1,"Me 1 1o, good evening and welcome". 0* fn 

L l 1 f f 1 

Os 51 ?-(ci ■ F*-tjoo151a f t) ,0 .'♦ill ta end o# sector with 0s 

eng 


Id a,'(HI * 

cp 0F6e 

ret : 

rst 10 * 

ire h t 

jr print 


There are one or twe things that may be worth noting about this example The first is that because 
BASIC normally has the address of the ERR NR system variable held in 1Y (so it can easily reference its 
system variables) It is important to Store 1Y and replace it before returning to the original U S R 

Just is before the stair is moved so that it sits in the central 32K of memory This will allow +3DOS 
routines to be called without havmg to move it again. 

The dodos subroutine may be useful m your own programs It only uses the !Y regisier which isn’t 
used by the +3DQS system and allows a call tc be made to any of the + 3DOSroutines 

The program uses DOS REF XDPB to make IX point at the relevant XDPB for drive A It then iocs m 
th. disk in A so that it can be written to. After calculating ana modifying the checksum byte for the 
information to be written to the boot sector of the disk, it writes the boot sectoi using DD WRITE 
SECTOR 

N< - checks are made to see that there is even a disk interface and possible errors are ignored - the 
r: inline isn t designed to be use. i by those unMmuai with possible pitfalls The routine can be called 
withthe BASIC command 

USR 28672 

which will come back with whatever number BC happens to contain after completion of the routine. 

The boot sector that is written to the disk has a standard disk specification in the first 16 bytes This is 
followed by the bootstrap code that will be entered at address ELI Oh. As will be described in the 
interface lor DOS BOOT (see part 27 of this chapter) the memory will initially be set up as 4. 7 6. 3, 
however the BASIC system vanables are still intact and BASIC can be- operated by switching in the 
correct ROM (3) to the bottom of memory and making sure that page 5 is ir. the 4000h 7FFFh area ol 
memory 

This very simple boor program ;usr uses the BASIC ROM to print a greeting then enters a tight loop 
changing the border co.our It could be modified tc load a large binary file and enter it or perform any 
other action yc u desired 
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Part 27 

Guide to +3D0S 

Subjects covered.., 

ROMs 

+3DOS interface 
File attributes and headers 
Disk format and specification 
Tracks and sectors 
Disk parameter blocks 
CP/M file compatibility 
Changing disks 

Logical to physical drive mapping 
+3DOS messages and requirements 
+3DOS routines 


this - -ction describe? + 3DC .'S - the disk operating systett ■ f the +3 The information will probably 
be of most interest to people familiar with assembly language (machine cod?) programming (see part 
26 of this chapter for more information on this subtec!! What follows is highly technical, and should net 
be used by the uninitiated. 

The operating software of (hi +3 is in effect held in four ROMs (though th- information is actually 
contained in just two |Cs) All four ROMs are addressed between OOOOh and 3FFFh although only one 
is switched in at a rtme 

' *3 it Wit • 

high level 'menutng and editing functions 

ROM 1 is the syntax’ ROM and handles the high level centre +3 BASIC It contains the code for 
the BASIC parts of most of the disk based commands. 

ROM 3 is the 48 BASIC ROM and is virtually identical to the ROM used in the very first Spectrum The 
only real area where it is different is m the code executed when an interrupt occurs If non zero ?. 
ticker’ variable is decremented every second interrupt ana when it reaches sere the disk motor is 
switched off This variable is held ir. page 7 along with some of the editor and DOS variables. Page 7 
will only be switched m (and this variable decremented! if bit 4 m the FLAGS system, variable is set 
this is used by the software to identify whether it is tunning 48 BASIC oi +3 BASIC Wher. 48 BASIC 
is selected (from the mam menu or by the SPECTRUM command) this Lit ts reset so that this 
page-switching and ticket-decrementing won't happen However if bit 4 m the FLAGS system 
variable is subsequently set by your own program this process wil start again whim interrupt moire 
is sttllse looted 

renin peeuut +2 i M - 

ihe +3 
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A t mg m the original 48 BASIC ROM has been fixed in the +3 When ■ : ,on maskable interrupt (NM1) 
occurs, a jump is made to location 66h This now checks the contents of the NM1ADD system variable. 
U IMS zero a RETN is executed, otherwise a -,uinp is made to the routine address held in NM1ADD The 
NMI code in ROM 2 consists of :ust a RETN 

ROM i not only provides the 48 BASIC mode for program compatibility, but executes the majority of 
+3 BASIC commands that don t make use of the more advanced hardware of the +3 

The fourth ROM (ROM 2) holds +3DOS ■ the disk operating system. This is the subiect of this section. 
Unlike the other ROMs, which are unlikely to be of much use fot assembler programmers (except the 
48 BASIC ROM perhaps), the +3DOS ROM has a wealth of routines that may well be ot use in yout own 
programs We strongly recommend that any software that uses the disk drives makes use of these 
routines as they pr vide most of the facilities that one could wish for (more than are currently used by 
BASIC in fact) Furthermore, the routines should only be accessed via the jump block This not only 
makes it easier to wnte software that car. be adapted to and from the AMSTRAD CPC range of 
computers, but also affords upwards compatibility for the future. The entry points for each routine are 
held m a jump table at address OlOOh (256) in the ROM Part 26 of this chapter gave a couple of 
examples of the way in which these routines can be called. 

+3DOS provides then vmg facilities 


* Support for one or two floppy disk drives and a RAMdisk 

* CP M Plus and CP. M 2.2 file compatibility 

* AMSTRAD CPC range and PCW range file and media compatibility 

* Up to 16 files open at the same time 

* Reading and writing files to or from any page m memory 

* Byte level random access 

+ Delenng disk files; renaming disk files, changing disk files attribute ■ 

* Selecting the default dnve and user 

* Booting a game or operating system 

* Lcwlevelaccesstofloppydtskdriver 

* Optional mapping of two logical drives (A < t B.) onto one physical drive (unit 0) 


+3DOS interface 

+3DOSs interface is a set of routines accessed via a ; imp block The rouunes provided fall into tint- 
categories 


* Essential hung system loutmes 

* Additional routines for games and operating systems 

* Low level floppy disk access routines for disk formatting, copying etc 
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The following is a Ils! of the routines in each of these categories (together with brief descriptions of the 
routines' functions) 


Essential tiling system routines 


NAME OF ROUTINE 

FUNCTION 

DOS INITIALISE 

Initialise +3DOS 

DOS VERSION 

Get 4-3DOS issue and version numbers 

DOS OPEN 

Create and or open a file 

DOSCLOSE 

Close a file 

DOSABANDON 

Abandon a file 

DOSREF HEAD 

Point at the header data lor this tile 

DOSREAD 

Read bytes into memory' 

DOS WRITE 

Write bytes from memory 

DOS BYTE READ 

Read a byte 

DOS BYTE WRITE 

Write a byte 

DOSCATALOG 

Catalog disk directory 

DOSFREESPACE 

Free space on disk 

DOSDELETE 

Delete a file 

DOS RENA ME 

Renames file 

DOS BOO r 

Boot an operating system, or other prograt: i 

DOSSET DRIVE 

Set get default dnve 

DOS SET USER 

Setgetdefault user number 


Additional routines for games and operating systems 


NAME OF ROUTINE 

FUNCTION 

DOS GET POSITION 

Get file pointer lot random access 

DOS SET POSITION 

Set file pointer for random access 

DOS GET EOF 

Get end of file position lot random access 

DOS GET 1346 

Get memory usage m pages 1.346 

DOSSET 1346 

Re allocate memory usage in pages. 3 4 6 

DOS FLUSH 

Bung disk up tc date 

DOS SET ACCESS 

Change open ‘tie s access rr.od-r 

DOSSET ATTRIBUTES 

Change a file s attributes 

DOS OPEN DRIVE 

Open a drive as a single file 

DOS SET MESSAGE 

Enable/disable error messages 

DOSREFXDPB 

Point at XDPBfor low level disk ac >:ss 

DOS M APB 

Mac B onto unit Oot 1 















Low level floppy disk driving routines 


NAME OF ROUTINE 

FUNCTION 

DD INTERFACE 

Is the floppy disk driver interface present 7 

DD1NIT 

Initialise disk driver 

DDSETUP 

Specify drive parameters 

DDSETRETRY 

Set try/retry count 

DDREADSECTOR 

Read a sector 

DD WRITE SECTOR 

Write a sector 

DD CHECK SFCTOR 

Check a sector 

DDFORMAT 

Format a track 

DDREAD ID 

Read a sector identifier 

DD TEST UNSUITABLE 

Test media suitability 

DD LOGIN 

Log m aisk, initialise XDPB 

DDSEL FORMAT 

Pre-mitialisp XDPB for DD FORMAT 

DD ASK 1 

Is unit i (externa! drive) present 7 

DD DRIVE STATUS 

Fetch drive status 

DD EQUIPMENT 

What type of drive 7 

DDENCODE 

Set intercept routine for copy protection 

DDLXDPB 

Initialise an XDPB from a disk specification 

DDLDPB 

Initialise a DPB from a disk specification 

DDL SEEK 

|iD765AseeK driver 

DDLREAD 

n PD765A read driver 

DDL WRITE 

mPDYSSA write driver 

DDL ON MOTOR 

Motoron wait for motor-on time 

DDL TOFF MOTOR 

Start the motor-off ticker 

DDLOFFMOTOR 

Turn the motor off 


Games and other non-BASIC programs 

+ 3D0S provides facihtiesspecificaily for non-BASIC programs 

* Us* DOS BOOT u n.j .i angle bootstrap .lor then take ..ver the whole machine (see the 
second example in part 26 o' this chaplet. 

* Claim some slon from +3DOS using DOS SB! ! 346 This enables a non-BASIC program to I ike 
control ot the machine but still use the facilities ‘ + 3DOS if required If + 3DOS is not required, 
then the non-BASIC program should cail DD L OFF MOTOR to force the drive motor off and 
disable the motor ticker Bit 4 in the FLAGS system variable should be reset to prevent any bank 
switching'variable decrementing on interrupt 

* A drive can be opened as a single file This enable - files and directories tc be examined without 
going via the file structure. 
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Using +3DOS without a floppy disk interface 


Even l! the floppy disk interface were not present, +3DOS could still be used as follows, 

* OniydnveM is available (the RAMdisk) 

* The default drive for filenames is initialised to M rathei than A, 

* Any attempt to use drives A orB, wall fail with error 22 - Drive not found 

* As the sector cache is not required for use with RAMdisk. the size of the RAMdisk is 
increased to 64K (the whole of pages 1. 3,4 6). This will give 62K of data and 2K of directory 
(64 entiles), 

* The presence of the floppy disk interface can be determined by calling DDINTERFACE: If 
the interface were not present then none of the other low level floppy disk routines (DD 
etc.) could be called, the effect of so doing is undefined 


File attributes 


Bit V of the name and type field characters are the file attributes The top bits of the name field 
characters are denoted f ] 0 The top bits of the type field characters are denoted tl 13 They have 
the following meanings. 

fl (4 Available to the user 
E (B Reserved (always 0) 

t! 0 means file is read-write. 1 moans file is read-only 

(2 - 0 means not system file. 1 means system file 
t3 - 0 moansnot archived; i means archived 

A read only file cannot be written to, erased or renamed System flies can. optionally, be omitted from 
Hie directory catalog The archive attribute is ignored by +3DOS 

Newly created files have all attributes set to 0 Ar. existing hie s attributes car only be changed by 
'OSSET AITRIBUTES(asusedbyBASlC''MOVE cc mmand) 

File headers 


Tap., files law headeis v/l»ch contain same system information +3DOSn.. - may . t may not, have 
headers Ac nles crowed by BASIC's SAVE rr.rr.ana will lia • header; 

The +3DOS header mechanism provides a aecncated 6 byte area ir. ; icn headed fu reserved: r 
BASICs use TV- remainder of the header is reserved for + iDOS T his & byte header is utilised m flies 
goated by BASIC commands (see DOS OPEN descrmnon) 
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+3D0S files may have a single header in the first 128 bytes of the file the header record These 
headers are detected by a signature' and checksum If the signature and checksum are as expected, 
rhen a header is present; if not, then there is no header Thus, it is possible, but unlikely that a hie 
without a header could be mistaken for one with a header 

The format of the header record is as follows 


Bytes 0 7 
Byte 8 
Byte 9 
Byte 1C 
Bytes It 14 

Bytes 15 22 
Bytes 23... 126- 
Byte 127 


+3DOS signature - PLUS3DOS' 

• 1 Ah (26) Soft - EOF (end of file) 

- Issue number 
Version number 

• Length of the file in bytes. 32 bit number, least significant byte u. 
lowest address 

+3 BASIC header data 

- Reserved (set toO) 

- Checksum (sum ofbytesG 126 modulo 256) 


The issue and Versio n numbers are provided tor any future expansion The issue number must equel 
the software s issue number the version number most be less than or equal to the software's version 
number 

+3DOS performs all the necessary header 'house-xveping' A pointer to +3 BASIC's 8 byte header 
area may be returnee using DOS REF HEAD. It is never necessary to wnle directly to the 128 byte 
header 


AMSDOS headers (as used or. the AMSTRAD CPC range of computers) will not be recognised 
AMSDOS files will be treated by +3DOSas header less, and vice versa 


Disk formats 

+3DOS supports exaeny the same disk format as CP M Plus and LocoSctipt on the AMSTRAD PCW 
range of computer word processors (le the first format listed below) 

The following formats are automatically detected when the disk is fust accessed 

* AMSTRAD PCW range single track (eg. as used on model PCW8256) 

* AMSTRAD PCW range double track (eg as used on mode! PCW8512) 

* AMSTRAD CPC range system formal 

* AMSTRAD CPC range vendor format 

* AMSTRAD CPC range data only format 

N re that the AMSTRAD CPC range's IBM format isnof supported 

Other disk formats can be used by patching the XDPB for a drive The XDPtJ is the ,amc- as tor the first 
torniatiist -i u ov- it is north: sa; e as or. the CPC range 
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Disk formats are subiect to the following restrictions 


* 512 byte sector size 

* Maximumof255sectorspertrack 

* Maximum of 255 tracks 

* Maximum of 256 directory entries 

* Maximum of 360 allocation units 


Logical tracks and sectors 

The disk driver routines require logical hacks ana sectors These are used to hide information 
concerning the number of sides and th< actual sector numbers from +3DOS which knows nothing 
about them 

Logical track numbers on a single sided disk are the same as physical track numbers 
For double sided disks, two options are available. 

1 Alternatmgsides 

side 0 track 0 = logical track 0 
side 1 track 0 = logical track 1 
side 0 track 1 = logical track 2 
side 1 track 1 = logical track 3 

..to.. 

side 0 last track = loqical track n-1 
side 1 Iasi track = logical track n 

2 Successive sides 

side 0 track 0 = logical track 0 
side 0 ttack 1 = logical track 1 
side 0 track 2 = logical track 2 
to 

side 0 last track = logical track n/2-1 
and then 

side 1 last track-1 = logical track m2 
side i last track-2 = ’ogical track m2+ 
side 1 last track-3 - 'logical trader. ?* 
to 

side i track 0 = logical track n 

where n is the total number ol logical rracxs ge c x number or traces oer siae i 
Logical sectors hide the actual physical sector numbers Logical sector numbers always start from 0 
Logical sector = physical serif i nrs'scctm 
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Disk specification 


The PCW range disk format (used by the +3) is. in fact, a fann y of formats the precise menibei of 
which is denned in the disk specification' which is recorded on bytes 0 13 of sector 1, track 0 side 0 
it used on the +3 type 0 belov 

also that used for a bootstrap program An example of how it may be set up is shown in the second 
oxa mple in part 26 of this chapter 


ByteO 

Disk type 

C = Standard PCW range DD SSST (and +3) 

1 = Standard CPC range DD SS ST system format 

2 = Standard CPC range DD SS ST data only format 

2 = Standard PCW range DD DS DT 

All other values reserved 

Byte 1 

Bits 0 1 Sidedness 

0 = Single sided 

1 = Double sided (a.ternatingsicies/ 

2= Double sided .successive sides) 

Bits 2. 6 Reserved (set to 0) 

Bii 7 Double track 

Byte 2 

Number ot tracks per side 

Byte 3 

Number ot sectors per hack 

byte 4 

Log (sector size)-7 

Byte 5 

Number of reserved track's 

Byte 6 

r«g (block size 128) 

Byte 7 

Number of directory blocks 

Byteb 

Cap imath (read wt ite I 

Byte 9 

Cap length (format) 

Bytes 10, 14 

Reserved 

Byte 15 

Checksum (used only if disk is bootable) 


When a disk is logged on the disk specification is used to mittaiise the relevant XL PB 
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Extended disk parameter blocks (XDPB) 

Associated with each (logical) drive is an extended disk parameter block (XDPB) This contains a 
standard DPB which is the same as that used by CP M Plus It also contains information required by 
+3DOS to support the different formats It may be patched in order to use differently formatted disks 
(provided that the restrictions detailed in the previous table are obeyed, 


XDPB structure 


Bytes 0 1 

SPT records per track 

Byte 2 

BSH log-(buck size 128) 

Byte 3 

BLM block size 128-! 

Bvte 4 

EXM extent mask 

Bytes 5 6 

DSM last block number 

Bytes 7 8 

DRM last directory entry number 

ByteS 

ALO directory bit map 

Byte 10 

All directory bit map 

Bytes 11 12 

CKS size of checksum vector (bit! 5 - permanent) 

Bytes 13 i4 

OFF number of reserved tracks 

Byte 15 

PSH !og : (sector size 128) 

Byte 16 

PH M sector size 1 128 -1 

Byte IV 

BitsO. ! Sidedness 
= Single sided 

1 = Double sided (alternating sides'' 

2 = Double sided (successive sidesl 

Bits 2 6 Reserved (set to 0) 

Bit 7 Double track 

Byte !9 

Number of tracks per side 

Byte 19 

Number of sectors per Hack 

Byte 20 

First sector number 

Bytes 21 22 

Sector size 

Byte 23 

Gap length (read write i 

Byte 24 

Gap length (format) 

Byte 25 

Bit 7 Multi-track operation 
i = multi-track 

0 = smg;e track 

Bit 6 Modulation mode 

1 = MFMntode 


J = FM mode 




Bit 5 Skip deleted data address mark 

1 = skip deleted data address mark 

0 = don’t skip deleted address mark 

Bits 0 4 = 0 

Byte 26 

Freeze flag 

OOh (0) = auto-detect disk format 

FFh (255)= don't auto-detect disk format 


Byte 25 is normal.y set to 60h (96) Mutti-tiack operation is not recommended 

Setting the freeze Sag (byte 26} prevents +3DGS from trying to determine the format of a disk Thi: 

should be used when patching an XDPB for a non-standard format 

The XDPBs tor the three main formats are as follows 


AMSTRAD PCW range single track format (type 0) 
(As used by the +3) 



SPT records per track 

3 

BSH block shift 

7 

BLM block mask 

0 

EXM extent mask 

174 

USM numberof blocks- ’ 

63 

DRM number of directory entries-1 

COM 192) 

ALO 2 directory blocks 

00h(0) 

AL1 

16 

CKS. size of checksum vector 

1 

OFF reserved tracxs 

2 

PSH physical sector shill 


PHM physical sector m-isk 

r; 

Single sided 

4C 

Tracks per side 

9 

Sectors per track 

1 

Fust sector number 

512 

Sector size 

42 

Gap length (read wrile) 

82 

Gap length (format ! 

60h(96) 

MFM mode skip deleted data address mark 

0 

Do auto select format 
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AMSTRAD CPC range SYSTEM format (type 1) 


36 

SPT records oer track 

3 

BSH block shift 

7 

BLM block mask 

0 

EXM extent mask 

no 

DSM. number of blocks -. 

63 

DRM, number ot directory entries • 1 

C0h(192) 

AW. 2 directory blocks 

00h(0) 

AL1 

16 

CKS size of checksum vector 

2 

OH' reserved tracks 

2 

PSH physical sector shift 

3 

PHM physical sector mask 

0 

Single sided 

40 

Tracks per side 

9 

Sectors per track 

4 lb (65) 

First sector number 

5)2 

Sector size 

42 

Gap length (read v/nte) 

82 

Gap length (format) 

60h(96) 

MFM mode skip deleted data aduiess mark 


Do auto select format 


AMSTRAD CPC range DATA ONLY format (type 2) 



3PT records pot track 

3 

BSH block shift 

7 

BLM block mask 

(1 

EXM extent mask 

179 

DSM number of blocks-. 

63 

DRM number of directory entries -1 

COh (192) 

ALO 2 directory blocks 

00h(0) 

ALi 

16 

CKS size of checksum vectc r 

0 

OFT reserved tracks 

2 

PSH physical sector shift 

3 

PHM, physical sector mask 













Single sided 

4C 

Tracks per side 

9 

Sectors per track 

Cth(193) 

First sector number 

5)2 

Sector size 

42 

Gap length (read/write) 

82 

Gap length (format) 

60h(96) 

MFM mode, skip deleted data address mark 

0 

Do auto select format 


CP/M File compatibility 

+3DOS uses the CP M file structure subject to the following restrictions 

* Maximum file sate of 8 r. -gabytes(CP M Plus supports a maximum ct 32 megabytes) 

* Maximum drive sire of 8 megabytes (CP M Plus supports a maximum of 128megabytes) 

* Directory labelsate ignored 

* No passwords XFCBs wil be erased, renamed, etc along with their fiie(s) but are 
otherwise ignored 

* No date and time stamps Sl'CBs are initialised to zero when a file is created t ut m 
otherwise ignored 

* The archive file attribute is ignored le H is unaffected by ail u mines except DOS SET 
ATTRIBUTES 


File model 

A file* is an array of bytes which may l> of any length ft cm 0 to 8 megabytes Associated with each 
open flic- is « 24 bit file pointer The fife pointer is the address of the next byte to b. • written or read The 
tiio pc,inter u ,utom,-,tica,ly advanced after each tend or /mite operation h> ,vev-*t the user may set it 
to any value required for random access 

J2QF) is the lowest byte position that ts greater than a)l written byte positions 
Hies without headers can only teccrd their EOF' position to the start of the next i28 byte record te 
ceiling (EOF ■! 28) Tiles with headers have their EOF position recorded exactly 

Writing a byte after the EOF position will extend the file and advance the EOF i situ • 

Reading a byte at ( r beyond ) the EOF position will return an FO! emu 

Reading an unwritten byte below the F.OF position v. hi cither n i an a n 'nsor:sic,T byte a ,p EOF 
error (Reading unwritten bytes is not recommended) 
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Changing disks 

Under + 3D0S a disk' may be chanqeci or removed whenever the drive is not being accessed (and 
there are nr, files open on that drive > There is no need to tea in a disk 

A disk sin >u!d not be changed while thete are hie? - pen on 11 If however f usk is changed whir 
there arc* ?nil hies o; n on it then as soon as +3DOS detects Hus. the user wiT be pi ompred tc insert 
tlv- correct disk +3DOScan only detect this change when it reads tn- directory from the disk 

Mote that changing •• disk while it is still being written to may oerrur.' the nata err the disk 

Logical to physical drive mapping 

If required two iodical <irtves (A- and S,) .-an mapped onto a single physical arive (unit 0) This may be 
useful for single disk drive systems. 

To enable this mapping the routine DOS MAP B is called, passing to it the address of a routine 
CHANGE DISK Whenever unit 0 is accessed a check is made to see if the dise in unit 0 is tor the 
required Icgicaldtlve If not then CHANGE DISK is called CHANGE DISK is passed the addressot i 
mcR-.wieand the required logical drive and the user should be prompted with the messaoe 

Please put the disk for x: into 
the drive then press any key 

re xrs the name nf the logical dnv< <. j A:, r B: ■ The routine should then wart for a key to fcn 
pressed before return):*:: after which u is assumed that the disk in unit o is for the- required logics, 
drive 

Pm *= MAP b tail i also be used to re-map B ntoumt, If unit 1 does rot exist then miveB isdisabled 

-f 3DOS Error codes 

Many +3DOS loutures can • ul This i- indicated with • rty aise ana an error code in the A reaisier 
The error cedesare. 

Recoverable dist'criors 



Drive not ready 

j 

Disk is write protected 

'/ 

Seek fail 

3 

CRC data error 

4 

No data 

5 

Missing address mark 

6 

Unrecognised disk format 

7 

Unknown disk error 

- 

Disk changed whilst +3D0S was using it 

U 

Unsuitable media for drive 
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Non-recoverable errors 



Bad filename 

21 

Bad parameter 

22 

Drive not found 

23 

File not found 

24 

File aIready exists 

25 

End of file 

26 

Disk full 

27 

Directory full 

28 

Read-only file 

2S 

File number not open (oi open with wrong access i 

30 

Access denied tilemuser.lieady) 

31 

Cannot rename between drives 

32 

Extent missing (which should be there) 

33 

Uncached (softwareerror) 

34 

File too big (trying to read or write past 8 megabytes1 

35 

Disk not bootable (boot secto t is not acceptable to DOS BOOT) 

36 

Drive in use (trying to le-mapoi removes drive with files open > 


As air example, the niport Unsuitable media for dr ive is caused by trying to write 
to a single track disk in a double track drive, or trying to tead or write a double track disk m a single 
track drive 

The report Missing address mark if the --rror returned when trying to access a disk that 
isr.ot formatted (although this is not the sole reason for the error) 


+3DOS Messages 

It -rror massacres are enabled (DOS SET MESSAGE) then, m the event ot a recoverable disk err: t 
I ■ I ■ < ■ 1 lldbt pi mptedt - Retry, 

Ignore or Cancel? If the user replies R. then the disk operation is reti led It the reply (51 
then the er tor is ignored, and tf the reply is C then the operation is cancelled and an error condition is 
returned to the caller If error messages ate disabled or if the error is not recoverable, then tic- 
message is displayed and an errci condition is returned to the cailer 
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The recoverable disk errors (m the range 0. 9) are 



Drive x: not ready 

1 

Drive x: disk write protected 

2 

Drive x: track ttt, seek fail 

3 

Drive x: track ttt, sector sss, data error 

4 

Drive x: track ttt, sector sss, no data 

5 

Drive x: track m, sector sss, missing address mark 

6 

Drive x: bad format 

7 

Drive ;<: track m, sector sss, unknown error 

8 

Drive x: disk changed, please replace 

4 

Drive x: disk unsuitable 


where x is the disk drive (eg A : iB: ttt is the tr-idcnuraber.andsssisth. imber. 

The above messages a re all‘ch.ved by-Ret ry , Ignore or Cancel? 

The ALERT routine is called to produce one of the >j messages if the error coirs once +31)05 is 
committed to execute a DOS routine. For example if DOS OPEN is called (with access ot exclusive 
write or read write ) ana the disk in the drive is write protected then it will return immediately with 
carry clear and A= i (the ALERT routine will notbecalied). 

If. however, while reading data during DOS READ a bad sector is found ALERT will be called to 
wam the user This will then offer theoppe rtunity of retrying (if for example the disk was not properly 
seated in the drive), ignoring (so that the bad sector will be ignored allowing as much of the file as 
possible to be recovered) or cancelling (perhaps because the problem is obviously irrecoverable) 

(Note that the routine interface for DOS SET MESSAGE has changed between versions V1 0 and V1 
of+3DOS It is important therefore that DOS VERSION is called and that if the version and mark are 
greater than VI 0, the new routine interface is used This is the only change between V l f) and VI 1 
and will omy be apparent lr. nor.-UK machines, j 

+3DOS requirements 

When any of the +3DQS r atines are called the fciicwir.a store configurate m is requited 

COOOh FFTPh (49152 65535) -Page7 
8000h BFFFh (3276S. 49151 > -Page 2 
4000h. 7FrFh (16384. 32767) -Page5 
OOOOh 3FFFh (0 16383) -ROM? 

The stack must be below BFEOh(49120) and above 4000h; .6384, The upper value is BFEOh tr-.thei 
than COOOh ) because the top 30 bytes, ot page 2 ate used to implement inter-page block m. The 
area is r.ot reserved by + 3DOS. it is merely required that the stack is not thru-: The stack must have it 
least 50 words available 

+3DOS supports up to 16 files open at any time Note however that file •. jmbet? ( 2 it utilised by 
+3 BASlC soitwouldbeunarisetouseth 1 -3 ■ ' 

be executed while a file is still open File C will always be closed when BASIC reports an error (ever, it 
Ihe repeat is 0 OK 

For each of the routines described m this section interrupts must be enabled on entry and will still 1> 
enabled on exit 
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+3DOS Store usage 

RAM pages 1, 3,4 6 ale treated as art array of 128 sector buffers (numbered C 127). each ef 5; 8 bytes 
i r.‘ i The RAMdtSrt M and the sector cache occupy two separate {connauc us) areas in this array 
Their sizes ana locations are preset daring mitt ilisanot! and ■:a:i be subsequently reset Tiny buffers 
not used by the RAMdtsk :u cache are free li t any other purpose Changing the size or location c ! the 
RAMdisk deletes all fits hies. 

A" +3DOS routines vn.'. exit with the same memory configuration as on entry 

The addresses of filenames, buffers etc passed to these routines must be visible te the RAM pa .to... 
which they are located must be switchea tr. 

The DOS jump biock is located in ROM 2 from address OiOOh .256) awards IIv address i 
interface for each routine are ns follows 


Essential filing system routines 

DOS INITIALISE 
0100h(256) 

Initialise+8DO: 

Initialise disk drivers 
Initialise cache and RAMdisk 
AH files closed 
Ah dr ives logged out 

Default drive A (if disk interface presentelse Vt 

Default 'user G 

Retry count .5 

Error messages disabled 

ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry false 
A = Error code 
Always 

BC DE Til IX corrupt 
Ailothei registers preserved 
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DOS VERSION 
0103h(259) 


Gel the DOS issue and veision numbers. 

ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

D = Issue 

E = Version (within issue) 
Always 

AFBCHUXconupt 

All other registers preserved 


DOS OPEN 
0106h(262) 

Create and or open a tile 

Thete is a choice of action aependma on whether or not the file already exists The choices are open 
action' or create action. and are specified m DE if the h!c- already exists then the open action t£ 
followed, otherwise the create action is followed 

Open action 

: Error Tile already exists 

2 Open the file read the header u: any j Position hie.pointer alter neaaer 
2 Open the hie ignore any header Position file pointer at QOOOh (01 

4 Assume given filename is filename. type Erase filename . B A K (if it exists) Fenarrr 
filename. type\ filename . BAK Follow create action 

5. Erase existing version Follow create action 

Create action 

1, Error • File does not exist 

2 Create and open new file with a header Position file pointer after header 
i Create and open new file without a header Position file pointer at 0000K h (it i 
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(Example. To simulate the rape iction : if the file exists open it otherwise create it with a headet 
set open action = i create ache = ! ) 

(Example To open a file and report an error if it does not exist set open action = 1 create action = 

(Example T'o create a new tile with a header, first renaming any existing version to .BAK set open 
action = 3, create action = 

Files with headers have their EOF position recorded as the smallest byte position greater than all 
written byte positions 

Files without headers have then EOF position recorded as the byte at the star! of the smallest 128 byte 
record position greater than all Written record positions 

Soft-EOF is the character .Ah (26) and is nothing to oc with the EOF position, only the i •mine DOS 
BYT! READ knows about Soft-EOF 

The header data area is 8 bytes iong and may be used by the caller for any purpose whatsoever If 
open action = 1. and the hie exists (and has a header) then the header data is read from the hie 
otherwise the header data is (reraised. The header data is available even if the file does not have a 
header Call DOS REF HEAD to access the header data 

Note that +3 BASIC mates use of the first 7 of these 8 bytes asfollows 


BYTE 

0 

1 

2 

3 

4 

5 

*1 

Program 

0 

hie length 

800 Oh or LINE 

offset to prog 

Numeric array 

1 

file length 

XXX 

name 

XXX 

XXX 

Character array 

2 

file length 

XXX 

name 

XXX 

XXX 

CODE iSCREENS 


file length 

load address 

XXX 

XXX 


- ttet 


It reattr : a that vvt., subsequently be LO A D i -within BASIC then these bytes .-the na be filled 
with the relevant values 

It the the is opened with exc,usive-write or exclusive -read-write access (and the ii.e has a header ; 
then the header is. updated when the :ne is closed. 

A hie that is sheady open for sharea-read access or. another hie number may only be opened for 
shsred-re-i(i access on this file number 

A no* that is • i lay open tot exc iisi.v r- • i i oxciJsive-WMto :t exclusive-ro :i -write access • n 
• i.i th't tile number rrnsy •. the 'penw rn this hie number 
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ENTRY CONDITIONS 

B= File number 0 >5 
C = Access mode required 
BirsC.. 2 values 

1 = exclusive-read 

2 = exclusive write' 

3 = exclusive-read-write 
5 = shared-read 

Bits 17 = 0 (reserved) 

D = Create action 
E = Open action 

HL = Address of filename (no wildcard.'-' i 


EXIT CONDITIONS 

If file newly created 
Carry true 
Zero true 
A corrupt 

if existing file opened, 

Carry true 
Zero false 
A corrupt 
Otherwise. 

Carry false 
A = Error code 
Always 

BC DEHLIX corrupt 
Another registers preserved 


DOSCLOSE 
0109h(265) 

Close a file 

Write the header (if there isrmo 
Write any outstanding data 
Update the directory 
Release the file number 

All opened flies must eventually be closed for abandoned) A file number cannot be reused turn) n it 
closed for abandoned), 
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ENTRY CONDITIONS 

B = Pile number 

EXIT CONDITIONS 

If UK 

Carry true 
A cor rupt 
Otherwise 
Carry raise 
A = Error code 
Always 

BCDEHLIX corrupt 
All other registers preserve* i 

DOSABANDON 
OlOCh (268) 

Abandon a file 

Similar t. DOS CLOSE except that any header or data or directory data yet to be written to disk is 
iiscaided This routine should niy be used tc force a file closed m the event that DOS CLOSE is 
ill', ibie to close the flic (for example it the media is damaged or permanently chanaed or removed). 

ENTRY CONDITIONS 

B = PilenumbeT 


EXIT CONDITIONS 

it OK 

Carry true 
A corrupt 
Otherwise 
Carry false 
A = Ft rot - de 
Always 

BCDE HI. IX corrupt 
All other registerspreserved 

DOSREFHEAD 
OlOFh (271) 

Poimatthe header data for this file 

The- header data area is 8 bytes long ana may De used by the caller tor any purpose whatsoever It is 
available even if the file does not have a header however file's with a header and opened with 
write access will have the header data recorded on disk 
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Note that +3 BASIC uses these 8 bytes (see the note under DOS OPEN which gives the details) It 
creating a file that will subsequently be LO A Ded within BASIC then these bytes should be filled with 
the relevant values 


ENTRY CONDITIONS 

B = File number 


EXIT CONDITIONS 

If OK. but file doesn t have a header 
Carry true 
Zero true 
A corrupt 

IX = Address ol header data in page 7 
I! OK , file has a header 
Carry true 
Zero talse 
A corrupt 

IX * Address oi Ereaderdata mp g 
Otherwise 

Carry false 
A = Error code 
!X corrupt 
Always, 

BC DEHLcorrupt 
Allother registers preserved 

DOSREAD 
0112h (274) 

Reed bytes from a hie into memory 
Advance the file pointer 

The destination buffer is in the following memory configuration 

COOOh rrrrh (49)52 65535) -Page specified mC 
6000b BFFTh (32768 49151) -Page2 
4000b 7FFI h (16384 32767) -Pace: 

00n0h,,3Frni (l! 16383) -DOS ROM 

This routine u. • t -onsiuei sjft-DQF 


I idrngl , 1 j utui>i men i 
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ENTRY CONDITIONS 

B = File number 

C = Page for COOflh (49132). FFFFh(65S35) 

DF = Number of bytes to read (0 means 64K) 

HL = Address for bytes to be read 

EXIT CONDITIONS 

If OK 

Carry true 
A DE corrupt 
Otherwise 
Carry false 
A = Error code 

DE = Number i >! bytes remaining unread 
Always 

BCHL IX corrupt 

All other registers preserved 

DOS WRITE 
0115h(277) 

Write bytes to a hie frcrr. memory 
Advance the file pomtet 

Die source buffer ism the following memory configuration 

COOOh F FFFh (49152 65535) - Page specified in C 
8000h BFFFh (32768 49151) -Page2 
4000h iT'FFh (16384 .32767) PageS 
OOOOh 3FFFh (0. 16383) DOS ROM 

ENTRY CONDITIONS 

B = File number 

- Page for COOOfci (-49132) FFFFh<65535 
DE = Number cf byres to write (0 means 64K) 

HI - Addresscfbytes to write 

EXIT CONDITIONS 

If OK 

Carry true 
A DE corrupt 
Otherwise 
Carry false 
A = Enor code 

DF = Number of bytes remaining unwritten 

Always 

BCHL IX corrupt 

Aj I other registers preserved 
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DOS BYTE READ 
0118h (280) 

Read a byte from a Me 

Advance the file pointer 

Tests for soft EOF (! Ah (26)) As this condition is not latched, it is possible to read past soft-EOF 
EOT is latched 

The caller mast decide whether or not soft-EOF is of interest This wouid normally be the case only 
when reading an ASCII file 

Reading EOF will produce an errot 

ENTRY CONDITIONS 

B = Tile number 

EXIT CONDITIONS 

IfOK-Byteo l Ah (26) (soft-EOF 
Carry true 
Zero false 
A corrupt 
C = Byte 

If OK - Byte = 1 Ah (26) (soft-EOF) 

Carry true 
Zero true 
A corrupt 
C = Byte 
t aherwise 
Carry false 
A = Errorcocie 
C corrupt 
Always 

BDEHLIX corrupt 

All other reoisterspreserve i 

DOS BYTE WRITE 
011Bh(283) 

Write a byte to a file 

Advance the file pointer 

ENTRY CONDITIONS 

B = File number 
C = Byte to write 


230 




EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry false 
A = Errot code 
Always. 

BCD! HI IXcorrupt 

All other teqtsters preserved 

DOSCATALOG 
011Eh(286) 

Fills a buffer with part ct the director/ (sorted) 

The filename specific s 'he drive jsg r and a (possibly ambiquous) filename 

Since the size of a directory is variable (and may be quite i rrge: this routine permits the directory to 
be catalogued in a number of small sections The caller passes a buffer pre-loaded with the first 
required filename- or zerc s for the start of the directory The buffer is loaded with part (or all. if it fits) of 
th> ■ directory sorted ir. ASCII order If nu re of the directory is required this routine is re-cailed with 
the buffer re-initialised ’with the last tile previously returned This pre cedure is fcllowed repeatedly 
until ail of the directory has been catalogued 

Note that + 3DQS format discs (which are the same as smgle sided, single track AMSTRAD PCW 
range format disks; may have a maximum of 64 directory entries 

Buffer format 

Entry C 
Entry l 
Entry 2 
Entry 3 
to 

Entry n 

ttl tin first filename. type r< |urr< . Entr] 

m itching filename ite-aer than the preloaded entry ( i: any; A zeroised preload entry isOK 

If the buffer is too email :*r the directory this routine can be caiiea again with entry? replaced by 
entry r.-tc fetch the next part .fthe directory 

Entry format (I j byt* •• . ng ; 

Bytes Fnename(ASCII > left-ustifiea space fmoci 

bytes- Type ASCII) left ustifted space nlieq 
bytes., i? • Sizemstlobytes;binary) 

is the amount cf disk space allocated t: the file i ■ • v , thl 

used by the file 
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ENTRY CONDITIONS 

B = n + 1, Si. 5 of buffer in entries. > = 2 
C - Filter 

bit 0 = include system files (if set) 
bits 1 7 = 0 (reserved) 

DE - Address of buffer (first entry initialised) 

HL = Address of filename (.wildcards permitted) 

EXIT CONDITIONS 

If OK. 

Carry true 
A corrupt 

B = Number completed entries in buffer, u.. .n. (If B = n. there may be more to come) 
Otherwise 
Carry false 
A = Error code 
B corrupt 
Always 

CDEHLIX corrupt 

All other registers preserved 

DOS FREE SPACE 
0121h (289) 

How much free space is there on this drive' 5 

ENTRY CONDITIONS 

A = Drive. ASCI! A P 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 

HL = Free space (in kilobytes) 

Otherwise 
Carry false 
A = Error code 
HL corrupt 
Always 

BC DE IX corrupt 

All other registers preserved 




DOSDELETE 
0124h(292) 

Delete anexisiinolilc 

t He must not be open on any ;i;e numDer 

ENTRY CONDITIONS 

Hi = Ad'it''!i '■. n .(ime(‘wr.ac.iraspetn;lll , *Ui 

EXIT CONDITIONS 

If OK 

Carry tnit 
A corrupt 
Otherwise 

Cany false 
A = Errc r - i> 

Always 

BC DEHLIX corrupt 

Al!' thet r-■<list'uspreserve I 


DOS RENAME 
0127h(295) 

Reniitne an existing tile 

must ■: imber Aft wrtl th< mustpot 

must spe cify or default to the same- drive ns the old r.amc 

ENTRY CONDITIONS 

DE = Adrit»s3ofriev/fiIenatne(nov/i!dcjrds 
HL = Aadressofold filename (no wildcards) 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry talsc 
A = Errori op 
Always 

BODE HLIX corrupt 

A:, 'th- t r- Msi -isijf -•••-rV- J 
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DOSBOOT 
012Ah (298) 

Bool from disk 

This routine loads a angle l > iotsttap sector from the disk in drr>- A into memory md enters it This in 
for loadmo game? or other operating systems 

Bootstrap environment 

COOOh EFFEh <49152 65535'. Paae: 

BOOOh BFFTh (32763 49151; -Paaet 

4000h 7FFFli (16334 32767. Peue 7 

OOClOh 3FFFh (0 J6333f -Page- 1 

The bootstrap sector is or, side 0 track. 1 sector. It is loaded at F'EOOh (65024) and entered at Fill Oh 
(65040/ Interrupts are disabled SP is at FEOOh (65024) The sum of all bytes in the sector must equal 
3 MOD256 (byte 15 can be set ic the required value to achieve this 

BytesC' 13 of the sector ho la the disk spectficati: r 

ENTRY CONDITIONS 

None 


EXIT CONDITIONS 

If OK 

Nc exit (as the be otsfrap mil. be eniere ti) 

Otherwise 
Carry false 
A = Error code 
Always 

BC DEHLlXcottupl 
Ah other registers preserv. < i 

DOS SET DRIVE 
012Dh (301) 

Set tliedelaun drive tie the orive implied by all tifouair.e? that d. • -i:v uttve 

The default drive is initially A 

Does not access the.it iv- buttf-p v clvvka If; athet-' iv.Kirr.vt t it. which o -••••••> irrr >V H> •' lh> 

•drive exists) 

This only affects routinesth-t t..x- u! - un* jvu misters 

ENTRY CONDITIONS 

A * Dnv- ASCII A F l l'h - t.j,udm-• 
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EXIT CONDITIONS 

If OK 

Carry true 
A = Default duve 
Otherwise 
Carry false 
A = Error code 
Always 

BCDEHL IX corrupt 

All other registers preserved 


DOS SET USER 
0130h (304) 

Set the default user area, ie, the 'user area implied by all filenames that do not specify a usei number 

fire deiault user number is initially 0 

This only aifecls routines that lake filename parameter:-., 

ENTRY CONDITIONS 

A = Usei 1A (F'Fh (25S) = get deiault use: 

EXIT CONDITIONS 

If OK 

Carry true 
A = Default user 
Otherwise 
Cany false 
A = Error code 
Always 

BCDEHL IX corrupt 

A,; other registers preset veol 


Additional routines for games and operating systems 

DOS GET POSITION 
0133h (307) 

Get the Hie pointer 

ENTRY CONDITIONS 

B = File number 
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EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 

E HL - File pointer OOOOOOh. FFFFFFh(0 16777215) 

(E holds most significant byte, L holds least significant byte) 

Otherwise 
Carry false 
A = Error code 
EHL corrupt 
Always 

BCD IX corrupt 

All other registers preserved 

DOS SET POSITION 
0136h (310) 

Set the file pointer 
Does not access the disk 

Does not check (or care) if pointer is > = 8 megabytes 

ENTRY CONDITIONS 

B = File number 

EHL = File pointer OOOOOOh ,FFFFFFh(0, 16777215) 

(E holds most significant byte, I, holds least significant byt >) 

EXIT CONDITIONS 

IfOK 

Carry true 
A corrupt 
Otherwise, 

Carry false 
A = Error code 
Always, 

BCDEHLIX corrupt 
All other registers preserved 

DOSGETEOF 
0139h (313) 

Get the end of file (EOF) file position, ,e the lowest byte position greater than si ; written byin 
positions 

Does not affect the tile pointer 
Does not consider soft-EOF 
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ENTRY CONDITIONS 

B= File numbei 


EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 

E HL = File pointer OOOOQOh. FFFFFFh <0... 16777215) 

(E holds most significant byte, L holds least significant byte) 

Otherwise 
Carry false 
A = Error code 
EHL corrupt 
Always 

BC DIX corrupt 

All oiher registers preserved 

DOS GET 1346 
013Ch (316) 

Get the current t ■ urn of the cache and RAMdisi: 

Pages 1, 3, 4 6are considered as an array of 128 sector buffers (numbered 0 127) each ot 512 bytes. 
The cache and RAMdiskoccupy two separate (contiguous) areas of this array 

Any unused sector buffers may be uspd by the cal,or 

Note that the sizes may be smaller than tliosespecified in DOS SET 1346, ns there is an (unpublished) 
maximum size of cache and a minimum size of R AMdisk (4 sectors) 

ENTRY CONDITIONS 

None 


EXIT CONDITIONS 

D = First buffer for cache 
E = Number of cache sector buffers 
H = Fust buffer for R AMdisk 
I, = Numb, i of R AMdisk sector buffeis 
Always 

AF BC IX corrupt 

All other registers preserved 

DOS SET 1346 
013Fh(319) 

Rebmid the sector cache and RAMdisk 

This toutine is used to make some store available to the user . r to return store t,; DOS 


237 




Note that if the h AMdisk is moved, i >r its size is changed then all files thereon are erased 

Pages 1.3 4. 6 are considered as an array of 128 sector buffers (numbered 0 12I).e-acn nf 5 tS tyres 
The cache and R A Mdisk occupy two separate (contiguous) areas of this array 

The location and size of the cache and RAMdisk can be specified separately, any remaining buffers 
are unused by DOS and are available to the caller 

The cache and RAMdisk must not overlap + 3DOS does not check this responsibility lies wth th- 
caller. 

Note that the sizes actually used may be smaller than those specified as m practice, there is a 
maximum cache size and a minimum size of RAMdisk (4 sectors) 

A cache size nf 0 will still work but will w nously impair the floppy disk pel formance 

Fins routine wil,' fail if there ,re any files open on drive M 

ENTRY CONDITIONS 

T; = fust buffer for cache 
f = Number of cache sector buffers 
H = Flist buffer for RAMdisk 
I = Number of RAMdisksectcu bufferr 
(Note that F, + L < = 128) 

EXIT CONDITIONS 

IfOK 

Carry ttue 
A corrupt 
Otherwise 
Carry false 
A = Error code 
Always 

BCDEHLIX corrupt 
Ail other registers preserved 


DOS FLUSH 
0142h(322) 

Wnteany pending headers Uat t directory entries tor this drive 

Fhis toutin'- erisui- •:) that (he disk i> ip to date It can be called at any nni* even ’.V!» : -re :::an 

ENTRY CONDITIONS 

A = Driv- ASCII A P 
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EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry false 
A = Error cade 
Always 

BCDEHLIX corrupt 

Al. i 'tiier registers preserved 


DOS SET ACCESS 
0145h (325) 

Try to change the access mode of an c pen tile. 

Fins routine will tail if the file is a.ready open m an incompatible accx ss mode or if write access is 
required for a read -only file or disk 


ENTRY CONDITIONS 

B= File number 
C = Access mode required 
BitsO 2 values 

. - exclusive-reaa 

2 = exclusive-write 

3 = exclusive-read WI it' 

5 = sharpcl-teacl 

(all other bn settings reserved) 
Bits2 7 = 0(reserved) 


EXIT CONDITIONS 

If OK 

Carry true 

A corrupt 
Otherwise 
Carry false 
A= Er rot "oe 
Always 

BODE HL. IXccrtupi 

AT tli—r registerspreserv-"i 
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DOS SET ATTRIBUTES 
0148h(328) 

Seta file's attributes 

Only the file attributes f 1 £4'. 1 1' i4'canbesetorcleaiPa The interface attributes 15 18 are always 0. 

rhts routine tirst sets the attributes specified in D, then dears those attributes specified in E. le E lias 
pnonty 

ENTRY CONDITIONS 

D = Attributes to set 
bit 0 = t3 Archive 
bit I = 12' System 
bit 2 = 11 Read-only 
bit 3 = f4 
bit 4 = Q 
bit 5 = f2' 
bit 6 = f 1 

E = Attubutes to cleat 
bit 0 = t3 Archive 
bit 1 = t?. 1 System 
bit2 = tl Read-only 
bit 3 = :4 
bit 4 = ra 
bit 5 = 12 
bit 6 = n 

HL = Addressof filename (wi idcaras permitted» 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 

Otherwise 
Carry false 
A = Error code 

Always 

BC DEHLIX corrupt 
All other registers preserved 

DOS OPEN DRIVE 
014Bh (331) 

Open the disic in this drive as a single file 

The whole disk is presented as a single tile regardless d any real files ithe disk Tins toutinecanbe 
used to examine poke directories hies etc !t should not be used by the uninitiated the faint hearted, 
ot by anyone whu values their hies 
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Sets file pointer to OOOOOOh (0). 

If there are any files open on this drive from other file numbers with shared-read access, then the disk 
can only be opened with shared-read access from this file number 

if there are any files open on this drive from other file numbers with exclusive access, then the disk 
cannot be opened from this file number 

ENTRY CONDITIONS 

A = Drive. ASCII A P 
B = File number 
C = Access mode required 
BitsO. 2 values. 

1 = exclusive-read 

2 * exclusive-wnte 

3 = exelusive-read-write 
5 = shared-read 

(all other brtsettings reserved) 

Bits 3 7 = 0 (reserved) 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry false 
A = Error code 
Always. 

BC DEHL corrupt 

All other registers preserved 


DOS SET MESSAGE 
014Eh(334) 

Enable/disable disk error messages. 

This should be used to make +3 DOS aware of your own ALERT subroutine When +3DOS detects an 
error, it will call your ALERT subroutine passing to it the values documented below The ALERT 
subroutine should print the text of the message that +3DOS passes it, then she aid wait for the user to 
press a key. If the key is m the ieply siting (that +3DOS also passes version V1 G only), then a ret 
should be made with A = 0,! or 2, or containing the character (depending on the version of+3DOS) 

ENTRY CONDITIONS 

A = Enable/disable 
mi (255) = enable 
OQh (0) = disable 

HL = Addressof ALERT routine (il enabled; 
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EXIT CONDITIONS 

HI.- iddressofpreviousALEFTrounne(Citnone) 
Always 

AF BCDEIX corrupt 
All other registers preserved 


NOTE 


Note that if yon are substituting yout . wn ALERT subroutine the entry conditions are tho 
conditions passed to yout subroutine and the exit conditions' are the values that your 
subroutine must produce and the registers you are allowed lo corrupt 

Note that there an two routine interfaces for ALERT The fust v whichis used in machines with 
+3D05 version V. 0) should have the entry and exit conditions shown aheaa 

ALERT (VERSION V1.0 ONLY) 

ENTRY CONDITIONS 

DE = Addressdf reply string an page i i tetmmatea ny FFh (255) 

HI. = Address of errot message (in p.ige 7) terminated by FFh (255) 

EXIT CONDITIONS 

A = Reply character 
Always 

FBC DF HI. IXcorrupt 
Another registers preserved 

The second . orsi •»: cl ALERT -which a.., ws the -user to provide non-UK error messages and is 
generally more flexible is present ui + 3DOS versions. ana upwards 

ALERT (VERSION VI. 1 AND ABOVE) 

ENTRY CONDITIONS 

E = Errot nmr.bet 

C = Drive ASCII A P 

D = I repeal tj act: (if i equired k t message. 

E = Logical sector (if required for message. 

HI. = AddressofUKen-'t mess t lefp.tgo 7) terminated by FFh (255- 

EXIT CONDITIONS 

A = Reply 
7 = cancel 
. = tetty 
= ignore 

A.WaVd 

F BCDEHLlXc rrrupt 
A.. caber i e-asters pi ceer ved 
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1 ! you provide an ALERT function, you should have two subroutines (rr , me wi'h swilchable 
entry and exit conditions) ana check tlv- +JDOS version number t- • i- leridrn' i which one 
to use: 

DOS REF XDPB 
0151 h (337) 

Point al the XDPB foi this drive tlThe XDPB is required by ihe floppy disk dnver routines ) 

ENTRY CONDITIONS 

A = Drive ASCII A P 

EXIT CONDITIONS 

liOK 

Carry true 
A corrupt 

IX = Addresser XDPB 
Otherwise 
Carry Disc 
A = Error • ue 
IX corrupt 
Always 

BC DEM [corrupt 

Al! other recisterspreserveu 

DOS MAP B 
0154h (340) 

Map drive B to unit 0 or unit. (This routine will fail if drive B has hies open j 

if uw.ppinq B tc unit C then each time unit is ace -ssed a .’heck is rraae that the ative tnapptna is 
rorrect If it isn t then a reverse call to CHANGE DISK is made tn ask the user to rhanrie the risk u 
until) 

IfrcappmoB tour.it, then i: unit 1 does net exist, drive B isdisnblen 

ENTRY CONDITIONS 

C=Umt(u : 

HL = Address :i CHANGE DISK routine if unit = 

EXIT CONDITIONS 

If OK 

Cirry Hue 
A corrupt 

HI s Addle*;, t previous CHANGE DISKi: jure i: r : 

Otherwise 
Carry (at* 

A HI. - rrut'i 
Always 

BC DE LX corrupt 

AH other ri-uisterspieserved 
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NOTE 


The definition of the subroutine CHANGE DISK is as shown ahead. Note that if you are 
substituting your own CHANGE DISK subroutine, the entry conditions’ are the conditions 
passed to your subroutine, and the exit conditions’ are registers you are allowed to corrupt. 

CHANGE DISK 

Ask the user to change the disk m unit 0 
Wait for the user to acknowledge the change. 

ENTRY CONDITIONS 

A = Logical drive ASCII A P 

HL = Address of message (page 7) terminated by FTh (2S5. 

EXIT CONDITIONS 

Always 

ATBCDEHLIX corrupt 
All other registers preserved 

Low level floppy disk driving routines 

The following are the floppy disk driver routines The unit number is 0. 3 for the ftPD765A. Or 
the V- 3 unit 0 is drive A. and unit) is drive B.. or optionally, both A. and B may be mapped onto unit! 
Units 2and 3 are not used 

With the exception of DD INTERFACE none of these routines may be railed If the floppy disk 
interface is not present 

All rounnes assume that interrupts are enabled on entry and will still be enabled on exit 

DD INTERFACE 
0157h (343) 

Is the floppy disk drive interface present? (This intormahoti Is also held by BASIC In bit 4 of the 
FLAGS3 system variable.) 

ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

If present 
Carry true 
Otherwise 
Carry false 
Always, 

A BCDEHLIX corrupt 
All ether registers preserved 
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DDINIT 
015Ah (346) 

Initialise the disk driver 

ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

Always 

AFBCDEHLIX corrupt 
All other registers preserved 


DD SETUP 
015Dh (349) 

Set up disk parameters. 

Send a specify command 
Parameter block format 

Byte 0 - Motor on time (in 100 mS units) 

Byte 1 - Motor ofl'nme (in 100 mS units) 

Byte 2 - Wr ite off time (in 10 /rS units) 

Byte 3 • Head settle time (in mS units) 

Byte 4 • Step rate (in mS units) 

Byte 5 - Head unload time (in 32 mS units, 32.. 480) 
Byte 6-(Head load time x 2) + 1 (in 4 mS units. 4. 502' 


ENTRY CONDITIONS 

HL = Address of parameter block 

EXIT CONDITIONS 

Always 

AFBCDEHL IX corrupt 
All other registers preserved 
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DD SET RETRY 
0160h(352) 

Set the try and retry count tAvalueo! I will try theopentior. once is noretry > 

ENTRY CONDITIONS 

A = Try/retry count > = - 

EXIT CONDITIONS 

Always: 

AF BODE ML IX corrupt 
All other registers pressrved 


DD READ SECTOR 
0163h (3SS) 

Read a sector 

ENTRY CONDITIONS 

B = Page for COOOh (49152) I TFFh(65535) 
C = Unit (0/1) 

D = Logical track, 0 base 
£ = Logical sector 0 base 
HL = Address of buffer 
IX = Address ot XDPft 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry false- 
A = Error code 
Always 

BCDEHLIX corrupt 
All other registers preserved 


246 



DD WRITE SECTOR 
0166h(358) 


Write a sector 

ENTRY CONDITIONS 

B = Page for COOOh (49132) FFTFh(65535) 
C= Unit (0/1) 

D = Logical track C base 
E = logical sector, 0 base 
HL = Address of buffer 
IX = AdaressofXDPB 

EXIT CONDITIONS 

If OK. 

Carry true 
A corrupt 
Otherwise 
Carry false 
A = Error code 
Always 

BC DEHLIXcorrupt 

All other registers preserved 


DD CHECK SECTOR 
0169h(361) 


Check a sector (Uses the mPD 765A scar, egualcomniana > 

Checks that the sect, r on disk is the same as ihe copy in memory. 

Note that FFh (255) or. disk or in memory always matches anything (see ;<PD765A specification for 
further details) 

ENTRY CONDITIONS 

B = Page for COOOh (49152) FFFFh(6SS35) 

C = Unit (O' l) 

D = Logical track 0 base 
E = Logical sector (1 base 
HI = Addresser copy .•■(sector 
IX = Address of XDPB 


247 


EXIT CONDITIONS 

IfOKtequ .). 

Cany true 
Zero true 
A corrupt 
If OK (not equal) 

Cany true 
Zero false 
A corrupt 
Otherwise 
Carry false 
A = Enor code 
Always 

BC DC HL !X corrupt 
All other registers preserved 

DDFORMAT 
016Ch (364) 

Format a trade (Uses the jxPD765A format trade command.) 

Buffer contains 4 bytes for each sector as follows 
C ■ Track number (0 .39) 

H Head number (always 0 on the +3 s single sided drive. 

R - Sector number (0,. 255) 

N-Loa (sector size)-? (2 for 512 byte sectors) 

ENTRY CONDITIONS 

B = Page for COOOh (49152). FFFFh(65S3$) 

C = Unit (0/1) 

D = Logical track. 0 base 
E = Filler byte, usually E5h (229) 

11L = Address of format buffer 
IX = Address of XDPB 

EXIT CONDITIONS 

If OK 

Carry true 
A corrupt 
Otherwise 
Carry lalse 
A = Error code 
Always. 

BC DEHLIXcorrupt 
All other r egrsters preserved 
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DD READ ID 
016Fh (367) 

Read a sector identifier 

ENTRY CONDITIONS 

C = Unit (0/1) 

D = Logical truck 1 base 
IX = Addressof XDPB 

EXIT CONDITIONS 

If OK 

Carry line 

A = Sector number from ldenniier 
Otherwise 
Carry false 
A = Error code 
Always 

HL = Address o! result buffer tr. page 7 

BCDKIX corrupt 

All other registers preserved 


DD TEST UNSUITABLE 
0172h(370) 

Check that disk- is suitable to write to 

A sincileirack disk will not work ma double track drive, and vica vers. 

ENTRY CONDITIONS 

C = Unit (0/11 

IX = AddressofXDPB 

EXIT CONDITIONS 

If suitable 
Carry true 
A corrupt 
Otherwise 
Carry false 
A = Error code 
Always 

BCDEHLIX corrupt 
All other registers preserved 
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DD LOGIN 
0175h(373) 


Log m a new disk 
Initialise the XDPb 

Phis routine does not affect or consider the freeze flag 

ENTRY CONDITIONS 

C = Unit (0,1) 

IX = Addiesso: destination XDPB 

EXIT CONDITIONS 

If OK 

Carry true 
A = Disk type 

DL = Size of allocation vector 
HL = Size of hush table 
Otherwise 
Carry false 
A = Error code 
DE HL corrupt 
Always 

BCIX corrupt 

All other registers preserved 


DDSEL FORMAT 
0178h(376) 

Imtuiise an XDPB for a standard format 

This routine does not affect or consider the freeze flag 


ENTRY CONDITIONS 

A = Disk - type 

- • 3 

; = AMSTRAP CPC range system formal 
2 = AMSTRADCPCrangedala-only format 
- = AMSTRAP PCW range DD PS DT 
iht.-r. Lues* error) 

IX = Address ofXDPB 
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EXIT CONDITIONS 

If OK 

Carry true 
A = Disk type 

DE = Size of 2 bit allocation vector 
HL = Size of hash table 
Otherwise 
Carry fa ise 
A = Error c ae 
DE: HL corrupt 
Always 

BCIX corrupt 

An other registers preserved 


DD ASK 1 
01 ZBh (379) 

Check to see it unit J is present (BASIC holds this information in bit 5 of the ELAGS3 system variable) 
Turn motor on 
fetch dnve status 

It unit I isnot-reaay and write-protected then unit 1 is missing Start motor off timeout. 

Note that this routine can be fooled by disks which are almost but not quite inserted in the drive 

This routine assumes that when a disk is not m the drive, then wnte-protcct is true Tins tsindeed the 
"ase for 3 inch and 8 inch disk drives, bill is not the case for 5 /, inch disk drives 

ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

If unit 1 present 
Carry ttue 
Otherwise 
Carry false 
Always 

A ECDf HL IX corrupt 
All other registers preserved 
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DD DRIVE STATUS 
017Eh (382) 

Issue a sense drive status command 

ENTRY CONDITIONS 

C = Umt/head 
bitsO. i = unit 
bit 2 = head 
bits3. 7 = 0 

EXIT CONDITIONS 

A = ST3 (Status register 3 o! fi PD765A 
Always 

FBCDEHLIX corrupt 
All other registers preserved 


DD EQUIPMENT 
0181h (385) 

Ask what type of drive tins is (le sing le/double track, single.- double sided) 

Track information can only be determined once a disk has been seen and had its type identified 
during logging in. 

Side information can only be detected after a double sided disk has been seen and had its type 
identified during logging in 

ENTRY CONDITIONS 

C= Unit (0/1) 

IX = Address of XDPB 

EXIT CONDITIONS 

A = Sidetrack information 
bits 0. I = side information 
0 = unknown 

1 = single sided 

2 = double sided 

bits 2 3 = track information 
0= unknown 

1 = single track 

2 = double track 

Always 

FBCDEHL IX corrupt 
A!! other registers preserved 
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DDENCODE 
0184h (388) 

Set the copy protection ENCODE subroutine 

Copy protected disks have some of their track and sector numbers encoded on disk Before each disk 
access the ENCODE subroutine is called to encode the the physical track and sector numbers. 

These encoded track and sector numbers must match those m the sector identifier 

Note that tracks 0 2 or either side of a disk should not be encoded 

ENTRY CONDITIONS 

A = Enable disable 
OOh (0) = disable 
FFh (255) = enable 

HL = (Ifenabled)addressofENCODE subroutine 

EXIT CONDITIONS 

HL = Adaressof previous ENCODE subroutine (0 if none) 

Always 

AFBCDEIX corrupt 
All other registerspreserved 


NOTE 


The definition of the subroutine ENCODE is as shown ahead. Note that if you are substituting 
your own ENCODE subroutine, the enhy conditions' are the conditions passed to your 
subroutine, and the exit conditions are the values that your subroutine must produce and the 
registers you are allowed to corrupt 

ENCODE 

ENTRY CONDITIONS 

C = Unit side 
bitsC l=unrt 
bit 2 = side 
bits 3 7 = 0 
D = Physical track 
E = Physical sector 
IX = Address of DPB 

EXIT CONDITIONS 

D = Encoded physical track 
E = Encoded physical sectoi 
Always 

AF corrupt 

All other registers preset veti 
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DDLXDPB 
0187h (391) 

Iradalise an XDPB tor a given format 

This routine does not allect or consider the freeze flag 

ENTRY CONDITIONS 

IX = AddressofdestinationXDPB 
HI = Address of source disk specification 

EXIT CONDITIONS 

If OK 

Carry true 

A = Disk type recorded on disk 
DE = Size of allocation vector 
HE = Size of hash table 
If bad format 
Carry false 
A - Error code 
DE HL corrupt 
Always 

BCIX corrupt 

All other registers preserved 


DDLDPB 
018Ah (394) 

Initialise a DPBfor agivenformat 

This routine does not affect or consider the freese fla g 

ENTRY CONDITIONS 

IX = Address of destination DPB 

HL = Address of sauce disk specifics'll v. 

EXIT CONDITIONS 

lfOK 

Carry true 

A = Disk type recorded on disk 
DE = Size c; allocation vector 
HL = Stzeofhash table 
If bad format 
Carry false 
A = Erior report 
DEI 11 1 corrupt 
Always 

BC IXcorrupt 

All other registers preserved 
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DDL SEEK 
018Dh(397) 


Seekto required track 
Retry if fails 

ENTRY CONDITIONS 

C = Umthead 
bits C 1 = unit 
bit 1= head 
bits 3 7 = 0 
D = Track 

IX = Addressof XDPB 

EXIT CONDITIONS 

II OK 

Carry true 
A corrupt 
Otherwise 
Carry fa.se 
A = Error report 
Always 

BC DEHLIX Corrupt 
Ail other registers preserved 

DDL READ 
0190h (400) 

Low level/rPD765A read command 

Read data 

Read deleted data 

Read a track 

Parameter block format 

EyteC - Page for C000h(4SI52) I FlTh(6S53S> 

Bytes 1 2 Address of buffer 
Bytes 3 4 Number of bytes to.ttanster 

Byte 5 Number of command bytes 

Bytes 6 ■ Command bytes 

Writes commands 
Reads data 

255 



Reads results 
Motor must be running 

ENTRY CONDITIONS 

HL = Address of parameter block 

EXIT CONDITIONS 

HL = Address 01 result buffer in page 7 
Always. 

Ar BC DEIX corrupt 
Allother registers preserved 


DDL WRITE 
0193h(403) 

Low leve:/rPD765A write command. 

Write data 
Write deleted data 
f ormat a track 
Scan equal 
Scan low or equal 
Scan high or equai. 

Parameter block format 

ByteO -PageforCOOOh(49152) FFTFh(65535) 

Bytes 1 2 -Address of buffer 

Bytes 3.. 4 Number of bytes to transfer 

Byte 5 - Number of command bytes 

Bytes 6 - Command bytes 

Writes commands 
Writes data 
Reads results 
Motor must be running 


ENTRY CONDITIONS 

HL = Address of parameter block 
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EXIT CONDITIONS 

HI i = Address of result buffer in pao> 

Always 

AFBCDEIXoorrupt 
Ali othe r rc-aisters preserved 


DDL ON MOTOR 
0196h (406) 

Tumor the tr ^ r 

Wait for the n: 'let >. tine as set by DD SETUP 

ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

Always 

At BCLtF: HLIX corrupt 
All other rensteis preserved 


DDL TOFF MOTOR 
0199h(409) 


Sturt the nn tr tirr mt 


ENTRY CONDITIONS 

None 

EXIT CONDITIONS 

Always 

AF BCCEHLIXcorrupt 
Alio(her k• rist-rsor**;nv ■ 


DDL OFF MOTOR 
019Ch(412) 

Turn oS the motor 

ENTRY CONDITIONS 

None 


EXIT CONDITIONS 

Always 

A! BCDEHLIXcorruct 
Allr'hei r eg inters preserved 
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Part 28 

Spectrum character set 


Subjects covered... 

Control codes 
Characters 

Z80 assembler mnemonics 


This is the complete Spectrum character set with codes ir, decimal and hex Ifor.e imagines the codes 
as being Z80 machine code instructions, then the right hand columns give the corresponding 
assembly language mnemonics As you may be aw'are. certain ZRO instructions are compounds 
starting with CBh or EDh these are shown in the twt right hand columns Where a character changes 
3 ten the +3 one. 


CODE 

CHARACTER 

HEX 

Z80 ASSEMBLER 

-AFTER CBh 

o 

- 


oo 

nop 

CO 

1 



Ul 

Id be NN 

i; '< 

6 


- nol u^ 


d *>c a 

Fed 

7 



03 

inebe 

rice 

4 



04 

meb 

rich 

S 



06 

deeb 

tlcl 

6 

PRINT comma 

06 

Idb.N 

rlc(hl) 

7 

[EDIT] 

01 

rica 

tlra 

8 

cursor left 0 

oa 

exal.af 

neb 

9 

cursor right C 

09 

add h! be 

rtcc 

10 

cursor down o 

0A 

Ida.(bc) 

rred 

11 

cursor up o 

0B 

dec be 

tree 

12 

[DELETE] 

OC 

mcc 

rrch 

13 

[ENTER] 

0D 

decc 

irel 

14 

number 

0E 

IdcN 

ric(hi.i 

IS 

not used 

OF 

rrca 

rrca 

16 

INK control 

10 

dwzDIS 

(lb 

17 

PAPER control 

11 

tdde NN 

rlc 

16 

FLASH control 

12 

ld(de a 

da 

J3 

BRIGHT ' uln 

13 

mede 

il * 

30 

INVERSEcor.'r: 

1 T 

me d 

dll 

2 1 

0 V E R -' : " 

73 

deed 

rll 

22 

AT o, city 

16 

id fl.N 

rl (bit 

23 

TAB ■ -Ire 

17 

ila 

da 

24 



IS 

ir D1S 

i(b 

25 


not jsed 

IS 

add hl.de 

rrc 


-AFTER EDh 
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CODE 

CHARACTER HEX 

Z80 ASSEMBLER 

-AFTER CBh -AFTER EDh 

26 


1A 

lda,(de) 

rr d 

27 


IB 

decde 

rre 

28 


- notusea 

nice 

rrh 

29 


ID 

dece 

nl 

30 


IE 

IdeN 

n (hi) 

31 


IF 

rra 

rra 

32 

space 20 

)r nz, DIS 

slab 

33 

I 

21 

Id hi. NN 

slac 

34 

n 

22 

ld(NN).h! 

slad 

35 

# 

23 

me hi 

slae 

36 

$ 

24 

inch 

sia h 

37 

7. 

25 

dech 

sla! 

38 

& 

26 

Idh.N 

sla(hl) 

39 

f 

27 

daa 

sla a 

40 

( 

28 

]r Z.D1S 

srab 

41 

) 

29 

add hl.hl 

srac 

42 

★ 

2A 

ldhl.(NN) 

srad 

43 

+ 

2B 

dec hi 

srae 

44 


2C 

mcl 

srah 

45 


2D 

dec! 

sral 

46 

• 

2E 

id IN 

sra(hb 

47 

/ 

2F 

cpl 

sraa 

48 

0 

30 

ir nc,D!S 


49 

1 

31 

Id sp. NN 


50 

2 

32 

ld(NN),a 


51 

3 

33 

mesp 


52 

4 

34 

me (hi) 


53 

5 

35 

dec (hi) 


54 

6 

36 

Id (hi), N 


55 

7 

37 

scf 


56' 

8 

38 

iicDIS 

srl b 

57 

9 

39 

addhl.sp 

srlc 

5S 

: 

3A 

Ida'NN) 

srld 

59 

t 

3B 

deesp 

srle 

60 

< 

3C 

me a 

srl h 

6l 

- 

3D 

dec 3 

sr)l 

6Z 

> 

3E 

lda,N 

sr! (hi) 

6: 

9 

3F 

ccf 

srl a 

64 

a 

40 

Idbb 

bit Ob mb.ic) 

65 

A 

41 

Id b e 

birO.c mi!(c),b 

66 

B 

42 

:dfcd 

bitO.d sbchl.bc 

67 

C 

43 

Id be 

bitO.e Id (NNl.bc 

68 

D 

44 

ldb.h 

bitCh nee 

69 

E 

45 

!db,l 

bit C ! rem 

rr 

F 

46 

!db (hi) 

birO.(hl) iraO 

71 

G 

47 

id b.a 

bitO.a Id^a 


H 

43 

idc.b 

bit lb Inc (cl 
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CODE 

CHARACTER 

HEX 

Z80 ASSEMBLER 

•AFTER CBh 

•AFTER EDh 

73 

I 

49 

Idc.c 

bit l.c 

out (c).c 

74 

J 

4A 

ldc.d 

bit l.d 

adchl, be 

75 

K 

4B 

Idc.e 

bit l.e 

Idbc.(NN) 

76 

L 

4C 

ldc,h 

bill'll 


77 

M 

4D 

Id c.l 

bun 

reti 

78 

N 

4E 

ldc,(hl) 

bu l.(hl) 


79 

0 

4F 

ldc.a 

bit l.a 

ldra 

80 

P 

50 

Id d.b 

bit 2.b 

ind,(c) 

8! 

Q 

51 

Idd.c 

bit 2.c 

out(c).d 

82 

R 

52 

Id d.d 

bn 2.d 

sbehl.de 

83 

S 

53 

ldd.e 

bit 2.e 

id (NN).de 

84 

T 

54 

ldd.h 

bn 2,h 


85 

U 

55 

ldd.1 

bn2! 


86 

V 

36 

ldd(hl) 

bn 2, (hi) 

im 1 

87 

W 

57 

Id da 

bit 2 a 

ld a t 

88 

X 

58 

lde.b 

bit 3.b 

me.(c 

89 

Y 

59 

Id e.c 

bit 3,c 

out (c],e 

90 

Z 

5A 

lde.d 

bit 3.d 

adchl.de 

91 

[ 

5B 

lde e 

bit3.e 

Idde.(NN) 

92 

\ 

5C 

Id e.h 

bit 3 h 


93 

] 

5D 

lde.1 

bit 3.1 


94 

t 

5E 

ide(hl) 

bit 3 (hi) 

im2 

95 


5F 

Idea 

bit 3,a 

Id a,r 

96 

£ 

60 

Id h,b 

bit4.b 

in h,(c) 

97 

a 

81 

ldh.c 

bn 4.c 

out(c),h 

98 

b 

62 

idh.d 

bit4d 

sbe hi hi 

99 

c 

63 

ldhe 

bit 4.e 

ld(NN).hl 

100 

d 

64 

Id h h 

bit 4 h 


101 

e 

65 

Id h.l 

bit 4.1 


102 

f 

66 

Idh.(hl) 

bit 4,(hi) 


103 

g 

67 

Id h.a 

bit 4.a 

lid 

104 

h 

68 

Id Lb 

bit 5.b 

in l.(c) 

105 

i 

69 

Idle 

bit 5,c 

out (C) 1 

106 

j 

6A 

Id Ld 

bit 5,d 

adchl 111 

107 

k 

6B 

IdLe 

bit 5 e 

!dhl.(NN) 

108 

L 

6C 

Idlh 

bit 5, h 


109 

m 

6D 

ldll 

bit 5.1 


110 

n 

6i: 

!dl.(hl) 

bn 5, (hi) 


111 

0 

6F 

Id la 

bn 5 a 

nd 

112 

P 

7o 

Id (hl).b 

bn 6. b 

ml,(cl 

113 

Q 

7 ] 

id(hl).c 

bit6,c 


114 

r 

72 

Id (hl),a 

bn 6. a 

sbe hi sp 

115 

s 

73 

Id (hi) e 

bn 6.e 

JfNKlSD 

116 

t 

74 

Id (hi) h 

bit 6 h 


117 

u 

75 

ld (hi) 1 

b« 6,1 


118 

V 

76 

halt 

bn 6 (hi) 


119 

w 

77 

Id (hi) a 

bit 6 a 
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CODE 

CHARACTER 

HEX 

Z80 ASSEMBLER 

-AFTER CBh 

-AFTER EDh 

120 

X 


78 

Ida b 

bit 7,b 

tna,(c) 

121 

y 


79 

Id a.c 

bit 7,c 

out (c).a 

122 

Z 


7A 

lda,d 

bit 7,d 

adchl.sp 

123 

{ 


7B 

lda,e 

bit 7,e 

ldsp,(NN) 

124 

I 


7C 

Ida.h 

bit 7.h 


! 25 

} 


7D 

lda.1 

bit 7.1 


126 

~ 


71 

Ida (hi) 

bit 7,(hi) 


127 

igj 


7r 

ida.a 

bit 7, a 


128 

□ 


80 

adda.b 

resO.b 


129 

a 


81 

add a.c 

resO.c 


130 



82 

adda.d 

resO.d 


131 

B 


63 

adda.e 

resO.e 


132 

□ 


84 

addali 

tesO.h 


133 

Ll 


35 

add a.l 

res 0.1 


134 

s 


86 

add a (hi) 

res 0. (hi) 


135 



87 

add a a 

resO.a 


136 

n 


88 

adca.b 

res 1 b 


137 

a 


89 

adca.c 

res l,c 


138 

i 


8A 

adca.d 

resl.d 


139 

r 


8B 

adca.e 

res l.e 


140 

u 


8C 

adca.h 

res l.h 


141 

j 


8D 

adc a.I 

res 1.1 


142 

k 


BE 

adca.(hl) 

res 1,(hi) 


143 

■ 


8F 

cldC 3,6 

res 1.9 


144 

(a) 


90 

subb 

res2,b 


145 

(b) 


91 

subc 

res2.c 


146 

(c) 


92 

sub a 

res2,d 


147 

(d) 


93 

sube 

res 2,e 


148 

(e) 


94 

subh 

res2,h 


149 

(f) 


95 

subl 

res 2,1 


ISO 

(g) 


96 

sub (hi) 

res2.(hl) 


151 

(H) 


97 

sub a 

res 2,a 


152 

(i) 


98 

sbcab 

res3.b 


153 

(i) 


99 

sbca.c 

res3,c 


154 

(k) 

. user 

9A 

sbca.d 

res3.d 


155 

(D 

orachics 

0B 

sbca.e 

res3,e 


156 

(m) 


9C 

sbca.h 

res3.h 


157 

(n) 


9D 

sbca.1 

res 31 


158 

(o) 


9E 

sbca.(hl) 

res 3 (till 


159 

(P) 


9F 

sbca.a 

res 3 a 


160 

(q) 


AO 

and b 

res4.b 

tdi 

161 

(r) 


Al 

andc 

res4,c 

cpi 

162 

(s) 


A2 

andd 

res4,d 

mi 

163 

SPECTRUM 

(t) 

A3 

ande 

res4.e 

nun 

*64 

PLAY (u) | 


A4 

andh 

res4,h 


165 

RND 


A5 

andl 

res 4.1 


166 

INKEYS 


A6 

and (hi) 

res 4. (hi! 
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CODE 

CHARACTER 

HEX 

Z80 ASSEMBLER 

-AFTER CBh 

-AFTER EDh 

167 

PI 

A7 

and a 

res4a 


168 

FN 

A8 

xorb 

res5,b 

Idci 

169 

POINT 

A9 

xorc 

ros5,c 

cpd 

170 

SCREENS 

AA 

xord 

res5d 

md 

171 

ATTR 

AB 

xore 

res5e 

outd 

172 

AT 

AC 

xoth 

ref 5 h 


173 

TAB 

AD 

xorl 

iesS.l 


174 

VALS 

AE 

xorfhli 

res5.(hl) 


176 

CODE 

AF 

xora 

res 5 a 


176 

VAL 

BO 

orb 

res6b 

Ida 

177 

LEN 

Bi 

QIC 

res6,c 

cpir 

178 

SIN 

B2 

oid 

res 6, a 

inir 

179 

COS 

B3 

ore 

res6e 

ohr 

180 

TAN 

B4 

orh 

res6,h 


181 

ASN 

BS 

oil 

res 6,1 


182 

ACS 

B6 

or (hi) 

res 6, (hi) 


183 

ATN 

B7 

Ora 

res 6. a 


184 

LN 

E8 

cpb 

res7.b 

idat 

185 

EXP 

B9 

cpc 

resZ.c 

cpdr 

186 

INT 

BA 

cpd 

res 7 d 

indi 

187 

SQR 

BB 

cpe 

res 7,e 

otdr 

188 

SGN 

BC 

cph 

res7,h 


189 

ABS 

BD 

cpl 

res 7,1 


190 

PEEK 

BE 

cp(hl) 

res 7. (hi) 


19! 

IN 

BF 

cpa 

Tes7,a 


192 

US R 

CO 

reinz 

setO.b 


193 

STRS 

Cl 

pop be 

setO.c 


194 

CHRS 

C2 

jpnz.NN 

set O.d 


19S 

NOT 

C3 

ip NN 

setO.e 


196 

BIN 

C4 

call trz.NN 

set Oh 


197 

OR 

C5 

push be 

set 0,1 


198 

AND 

C6 

adda N 

setO.(hl) 


199 

<= 

C7 

tsfO 

setOa 


200 

> = 

C8 

retz 

set l b 


201 

<> 

C8 

ret 

set l c 


202 

LINE 

CA 

jpz.NN 

set l.d 


203 

THEN 

CB 


sot l,e 


204 

TO 

cc 

calizNN 

set 1 h 


205 

STEP 

CD 

call NN 

set 1,1 


206 

DEF FN 

tl 

adca.N 

set 1 (hi) 


207 

CAT 

CF 

tstO 

set 1 a 


208 

FORMAT 

DO 

rot nc 

set2.b 


209 

MOVE 

D1 

popde 

set 2,c 


210 

ERASE 

D2 

ipnc.NN 

set 2 d 


211 

OPEN n 

D3 

ouf(N).a 

set 2 e 


212 

CLOSE It 

D4 

callnc NN 

set2 h 


213 

MERGE 

D5 

pushao 

S5f2l 
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CODE 

CHARACTER 

HEX 

Z80 ASSEMBLER 

-AFTER CBh -AFTER EDh 

214 

VERIFY 

D6 

subN 

set 2,(hi) 

21S 

BEEP 

D7 

rst 16 

set 2,a 

216 

CIRCLE 

D8 

retc 

set3,b 

217 

INK 

D9 

exx 

set3,c 

316 

PAPER 

DA 

jpcNN 

set3,d 

21S 

FLASH 

DB 

ina.(N) 

set3,e 

220 

BRIGHT 

DC 

call cNN 

set 3,h 

22! 

INVERSE 

DD 

prefixes 
instructions 
using ix 

set ii 

222 

OVER 

DL 

sbca.N 

set 3,(hi) 

223 

OUT 

DP 

rst 24 

set 3.a 

224 

LPRINT 

EO 

ret po 

set4,b 

225 

LUST 

El 

pop hi 

set 4 c 

226 

STOP 

E2 

jppo,NN 

set4.d 

227 

READ 

E3 

ex (sp) hi 

set 4 e 

228 

DATA 

E4 

callpo.NN 

set4.h 

229 

RESTORE 

E5 

push hi 

set 4,1 

230 

NEW 

E6 

andN 

set 4,(hi) 

231 

BORDER 

E7 

rst 32 

set 4 a 

232 

CONTINUE 

E8 

letpe 

set 5 b 

233 

DIM 

re 

IP (hi] 

set 5,c 

234 

REM 

EA 

;ppe NN 

set 5. a 

235 

FOR 

EB 

exde.hl 

set5,e 

236 

GOTO 


C3u ptr.kVlt 

IH« 

liJj 

GO SUB 

EC 



238 

INPUT 

EX 

xorN 

set 5, (hi) 

239 

LOAD 

EF 

rst 40 

set 5,a 

240 

LIST 

F'O 

tetp 

set6.b 

241 

LET 

FI 

pop af 

set6,c 

342 

PAUSE 

F2 

IPpNN 

set6d 

243 

NEXT 

F3 

di 

sete.e 

244 

POKE 

F4 

callp.NN 

set6.h 

245 

PRINT 

re 

push at 

set 6.1 

246 

PLOT 

F6 

orN 

set 6, (ho 

247 

RUN 

F7 

rst 48 

set b.a 

246 

SAVE 

F8 

reiru 

set 7,b 

249 

RANDOMIZE 

F9 

Idsp.hl 

set 7 c 

250 

I F 

FA 

IP m.NN 

set7,d 

251 

CLS 

TB 

ei 

set 

262 

DRAW 

FC 

call in, NN 

set7h 

253 

CLEAR 

FD 

prelixes 
instructions 
using ly 

set 7.1 

254 

RETURN 

rt 

cp N 

set/di.i 

255 

COPY 

FF 

rst 56 

set / a 
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Part 29 
Reports 

Subjects covered... 

Reports and messages 
CONTINUE 

Reports appear at the bottom of the screen whenever the +3 has stopped xecutmg some BASIC 
They explain why it has stopped be it for some natural reason, or because an error has occurred 

Most reports iiave a code number or letter (so that you can refer the table ahead), a brief message- 
explaining what happened, and the line number (and the statement number within the line) wher~ 
BASIC stopped (A command is shown as line 0 Within a line statement 1 is at the beginning 
statement 2 comes after the first colon (or T H E N , and so or.) 

Reports pertaining to disk operation (or +3DOS) do not start with a number or letter they are show:: 
ahead in alphabetical order 

The behaviour of the CONTINUE command depends very much on the reports Normally 
CONTINUE goes to the line and statement specified in the last report, but there aie exceptions with 
reports 0 9 and D 

Here is a table showing all the reports The naht-hand column telle you in which cucumstances thi- 
report can cccui and this refers you to part 31 of this chapter For example you can see from the table 
that the error A Invalid argument can occur With $ Q R LN ACS ASNandUSR Ifyou 
then look up these keywords in part 3! of this chapter y. >«i wilj be abie to find out just which arguments 
are invalid 

Disk errors rnatked by RIC tin the left-hand * lumn) wi.i normally be displayed followed by the 
options - Retry, Ignore or Cancel? If the cancel option is chosen, then the 
report shown m the second column will be displayed 


CODE 

REPORT/EXPLANATION 

SITUATION 

0 

OK 

Any 


Successful completion, or jump to a line number bigger 
than any existing This report does rot change the iine 
md statement tumped to by C 0 N TIN U E 


1 

NEXT without FOR 

The centre! variable does not exist (it has not been set up 
by a F OR statement'' but there is at ordinary vanat ■.< 
with Ihe same name 

NEXT 
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CODE 


REPORT/EXPLANATION 


SITUATION 


2 

Variable not found 

For a simple variable this will happen it the variable ts 
used before it has been assigned to by a L E T READ 
.[INPUT statement, oaded from disk (or tape) or set 
upma FOR statement For a subscripted variable if 
will happen if the variable is used before it has bhen 
dimensir i.ed m a D IM statement, or loaded from cusk 
(or tape) 

Any 

3 

Subscript wrong 

A subscript is beyond the dimension cf the array oi 
there are the wrong number of subscripts. If the 
subsciipt is negative or bigger than 65535, then error B 
will result 

Subscripted variables 
Substrings 

4 

Out of memory 

There is nor enough room in the computer for what you 
are trying to ao If the computer really seems to De stuck 
tn this state, you may have to clear out the command line 

DELETE 

(with the Intention of putting them back afterwards) tc 
give yourself room, t : manoeuvre 

LET INPUT FOR 

DIM GO SUB 

LOAD MERGE 

Sometimes during 
expression evaiuatioi. 

5 

Out of screen 

A; INPUT statement has tried to generate more than, 

23 lines in the lower half of the screen Aisc occurs with 

PRINT AT 22, xx 

INPUT 

PRINT AT 

6 

Number too big 

Calculations have yielded a number greater than 
approximately 1C 

Any arithmetic 

i 

RETURN without GO SUB 

rherehasl ■ ■ return• - .'.-••i* 

GO SUBs 

RETURN 

D 

STOP statement 

Alter this C 0 N T IN U E wi ii not repeat the STOP but 
carries c t ; with t he statement after 

STOP 

fl 

Invalid argument 

The argument for a function is unsuitable (tor some 
reason) 

SQR LN ASN ACS 

USR (with string 
argument) 

B 

Integer out of range 

Whenan integer is required the floating point argument 
is rounded to the nearest integer If this is outside a 
suitable r ar.ge then this error results 

For array access see also error 3 

RUN RANDOMIZE 

POKE DIM GO TO 

GO SUB LIST 

LLIST PAUSE 

PLOT CHRI PEEK 

USR i with numeric 
a aimer" 







CODE 


REPORT/EXPLANATION 


SITUATION 


C 


Nonsense in BASIC 

The text of (he (string > argument does not torma valia 
expression Also used when the argument tor a function 
-: command is outrageously wrong 


VA L VA L$ 


D BREAK - CONT repeats 

BREAK 

peiation The behaviour of CONTINUE after this 
report is norma! m that it repeats the statement 
Compare with report L 


E 

F 

G 


Out of DATA 

You hove tried'■:> READ past the end of tj.- DATA 

Invalid filename 

SAVE with filename empty' or. r. re: t, an 

characters using tape). 

No room for line 

There is not enough room left in memory to 
accommodate the new program line 


LOAD SAVE 
VERIFY MERGE 

Also used when the 
computer asks 

scroll? 

press N BREAK u the 
space bar 

READ 

SAVE 


Entering a line into 
the program 


H 


I 


STOP in INPUT 

Some INPUT data started with STOP Unlike the 
.9 : "CONTINUE. 

behave o rm ally by rep.- -ting the INPUT slat: me -1 

FOR without NEXT 

1 FOR : 1 : tecul It tit 
FOR n= 1 TO 0 mdth NEXT 

statement could not be round 


INPUT 


FOR 


J 


Invalid I/O device 

T cu are attempting tc input characters from (or output 
characters tc) a device that cioesn t suppe rt it Fci 
example it is net possible tc input characters from the 
a nstr mmandsu h INPUT #?,a$ 

will therefore result in this error 


Stream operations 

OPEN H 
CLOSE n 
INPUT # 
PRINT ti >tr 
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REPORT EXPLANATION 


SITUATION 


Invalid colour INK PAPER 

The number specified is not an appropriate value BORDER FLASH 

BRIGHT 
INVERSE OVER 

also after one of the 
corresponding control 
characters 

BREAK into program Any 

BREAK pressed This is detected between two 
statements The line and statement number in the report 
refeT to the statement before BREAK .vas pressed, but 
CONTINUE goes to the statement after (allowing for 
any jumps tc be made). so that it aoes not repeat any 
statements 

RAMTOP no good CLEAR possiblym 

The number specified for RAMTOP is either too bio or RUN 

too small. 

Statement lost RETURN NEXT 

Jump t'‘ a stammer! that no longer exists CONTINUE 

Invalid Stream INPUT t) 

Trying to input from (or output to) a stream that isn't open OPEN # 

or that is out of range (0. 13), or trying to open a stream PRINT It 

that isoul of range 

FN without DEF FN 

User-defined function used without a corresponding 
DEF the program 

Parameter error FN 

Wrong numberof arguments or one of them is the 
wrong type (string instead of number - r vice versa < 

Tape loading error VERIFY LOADor 

A hie ■ r. tape was found but for some reason could not be MERGE 

rc-aa in. < :r would not verify 

Too many brackets PLAY 

Too many brackets around a repeated phrase in one :: 
the arguments. 

Invalid baud rate FORMAT LINE 

The baua rate for the RS232 was set tr zero 

Invalid note name PLAY 

PLAY came across a note or commana it didn 1 
recognise or a command which was m e wer casv- 
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CODE 

REPORT EXPLANATION 

SITUATION 

l 

Number too big 

A parameter for a c' mmand is a ' 1 order of magnitude too 
big. 

PLAY 

m 

Note out of i'ange 

A series of sharps or flats h • taken a note beyond the 
range of the sound chip 

PLAY 

n 

Out of range 

A parameter for a command is too big o. »uc small If the 
error is very large error L results 

PLAY 

0 

Too many tied notes 

Ar. attempt was made to tie too many notes together 

PLAY 


Bad filename 

The filename used m any of the disk commands does not 
conform to the limits described in pair 20 of this chapter. 

CAT COPY 
ERASE FORMAT 
LOAD MERGE 
MOVE SAVE 


Bad parameters 

One of the values passed to +3DOS by BASIC is out of 
range It is unlikely that this error will ever be seen 

Unlikely 

RIC 

CRC data error 

The cyclic redundancy check (checksum byte) for a 
sector is incorrect This is a rare error that is produced if 
thedisk being read has been corrupted msome way 
(perhaps magnetically) 

CAT COPY 
ERASE LOAD 
MERGE MOVE 
SAVE 


Code Length error 

Pryingt id i code.- ■■ itskthatts tig h 'nan 
the value given in the LOAD ; >n mand 

LOAD CODE 


Destination cannot be ui Id 

Trying to give a wildcard file specification for the 
destination file m a C 0 P Y command when the source 
also contains wildcard characters In this case tht 
destination can only be a drive letter 

COPY TO 


Destination must be drive 

The source filename ma COPY command contains 
wildcard characters but ’ho destination is only a single 
filename In this case the oestir,alien can only bea 
drive letter 

COP 1 ' TO 
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CODE 


REPORT/EXPLANATION 


SITUATION 



Oi rectoryfull 

Frying to create the 65th file on a disk; (the normal disk- 
directory can only have 64 entries) 

COPY SAVE 


Disk full 

Saving oi copying files to a disk has used the last byte of 
free -.pace- The CAT command can be used to check 
that there is sufficient free space before attempting such 
an operation When copying, any partially-copied files 
will be deleted However when saving, it is possible 
that part of the file may be left on the disk this part 
should be erased as any attempt to use it will taii. 

COPY SAVE 

RIC 

Disk has been changed 

While executing a command, +3DOS has noticed that 
the disk in the drive is not the same one that waspiesent 
it the beginning of command execution. If a machine 
code program has opened fileson a disk (then the disk is 

• 3 

the disk, then this report will be produced 

CAT COPY 

ERASE LOAD 

MERGE MOVE 

SAVE 


Disk is not bootable 

An attempt has been made to load the bootstrap 
program irom a disk that doesn't have a boot sector. 

LOAD "*" 

RIC 

Disk is write protected 

An attempt has been made to wnte to a disk whose write 
protect hole is open Write protection may be disabled 
by sliding closed the appropriate tab before the disk is 
written to 

COPY ERASE 
FORMAT MOVE 

SAVE 


Drive B: is not present 

An attempt has been made to use the F 0 R M A T 
command on the external disk drive (anve B) when it 
l ias not been connected 

FORMAT 


Drive in use 

An attempt has been made to re map a drive that has 
files open on it It is very unlikely that this error will ever 
be seen 

Unlike-*/ 


Drive not found 

A filename used in a disk command contains a drive 
letter specifying a drive that isn t present For example 

ERASE "c:f red" 

CAT COPY 

ERASE LOAD 

MERGE MOVE 

SAVE 
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CODE 


REPORT/EXPLANATION 


SITUATION 


RIC 

Drive not ready 

A disk command has been attempted when the dnve 
was not ready This usually happens because there ts no 
disk m the drive It will usually be possible to simply put 
a disk in the drive and type R 

CAT COPY, 

ERASE FORMAT 
LOAD MERGE 

MOVE SAVE 


End of file found 

An attempt has been made to read a byte past the 
end-ot-file position It is unlikely that this report wi 11 be 
seen 

Unlikely 


File already exists 

The destination filename m a MOVE command (that ts 
being used to rename a file) already exists 

MOVE TO 


File already in use 

If a machine code program has opened files 1. 3 ihena 
+3 BASIC command might fail with this error when it 
tries toopen a file that was already open It is unlikely 
that this error will ever be seen 

Unlikely, COPY 

LOAD MERGE 

SAVE 


File is read only 

Trying to update, erase or save using the name of a file 
that has its protection attribute set (using the command 
MOVE filename TO '* + P") Use the command 

MOVE filename TO "-P" to remove write 
protection 

COPY ERASE 

MOVE SAVE 


File not found 

The filename given for one of the disk reading 
commands specifies a file that does not exist 

COPY ERASE 

LOAD MERGE 

MOVE 


File not open 

A disk command has tried to operate on a file which has 
not been openea It is very unlikely that this err: r will 
over be seen 

Unlikely 


File too big 

An attempt has been made to write a file that is greater 
than 8 megabytes in length. It is very unlikely that this 
error will ever be seen. , 

Unlikely 


Invalid attribute 

The attribute character in lowing + or - in a M 0 V E 
command is not P SnrA or there ts more than one 
character after the + . r - 

MOVE TO 


Invalid drive 
n.. ■ • " ■ A : : B : 

a FORMAT command 

FORMAT 
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CODE 


REPORT/EXPLANATION 


SITUATION 


RIC 


Missing address mark 

A sector being read ftom the disk dees not contain the 
usual information that is used by the system to identify 
where it is on the disk This almost invariably means that 
an attempt is being made to react a disk that has not been 
formatted The error may possibly occur when trying to 
read a disk that has become corrupted in some way, or 
one that employs some form of m-built protection 


CAT COPY 
ERASE LOAD 
MERGE MOVE 
SAVE 


RIC 


RIC 


Missing extent 

f Ties are essentially made up of 16K blocks and each of 
these :s known as an extent This errcT might occur while 
reading a file from disk if the disk is changed after the 
system has reaa the directory entry for a file (but before 
it has read a particular extent. However itisverv 
unlike ly that this error will ever be seen. 

No data 

This is a low level disk erroi that occurs when a sector 
identifier cannot be found It is possible that the c-iror 
might occur while trying to copy a disk that employs 
some form of m-built protection 

No rename between drives 

An attempt has been made to use the MOVE » mmand 
specifying source ana destination filenames that are or 
different drives 

Seek fail 

This is a hardware error that means the drive is unable re 
locate the track that has been requested li this arm r 
persists, u may indicate that the computer needs to be 
serviced 

Uncached 

This is on internal system error and it every unlikely that 
it will ever be seen. 


Unlikely COPY 
LOAD MERGE 


CAT COPY 
ERASE LOAD 
MERGE MOVE 
SAVE 


MOVE TO 


CAT COPY 
ERASE FORMAT 
LOAD MERGE 
MOVE SAVE 


Unlikely 


RI 


C Unknown disk error 

An eri'.r has occurred that the system is, i familiar 
with It is ver y unli ke i y that it will ever be seer 


Unlikely CAT COPY 
ERASE FORMAT 
LOAD MERGE 
MOVE SAVE 
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CODE 


REPORT/EXPLANATION 


SITUATION 


RIC 

Unrecognised disk format 

CAT COPY 


While trying to read'wnte a disk +3DOS has been 

ERASE LOAD 


unable to recognise its format, le. it has read the disk 

MERGE MOVE 


specification but has found information there that doesn t 
make sense This error may occur when trying to access 
disks which employ some form of m-built protection 

SAVE 

RIC 

Unsuitable media 

CAT COPY 


The disk in the drive has a format that is not suitable This 

ERASE FORMAT 


error might occur when for example trying to write tc 

LOAD MERGE 


an 80 hack disk placed in the (40 tracs i disk drive of the 

+3 

MOVE SAVE 
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Part 30 

Reference information 

Subjects covered... 

Hardware 

The 43 is desired around the ZaOA microprooessor which nu it a speed 54( IMHi 
three arid half million eycies per second j 

The +3 s memory is divided into 64K ROM and 128K RAM. arranged in 16K pages The four ROM 
pages (0-3) can be mapped into the bottom 16K (0Q00h-3FFFhj of the memory map The eight RAM 
pages (0-7) are usually mapped into the top 16 K (COOOh-FFFFh) of the memory map. RAM page 5 is 
also mapped into the range 4000h-7FFFh. and PAM page 2 is mapped into the range UOOOh-BFFFh. 
There are also several PAM page combinations that occupy ihe full 64K address range These were 
given in part 24 of this chapter, under the heading Memory management 

Physically speaking, the ROMs are two 32K devices (similar to the 27256) which are tioth treated by 
the system as two ISK chips I'he RAM is composed cf lour 64K x 4 bit chips (41464) some ol which 
(RAM banks 4 7) arc time -shared between the circtn'ry that produces the screen display and the 
Z80A The C'thers (RAM banks C-3i are for the exclusive os- u the /80A as is Ihe ROM 

For the contended RAM which shares lime between the vide circuitry and the processor), during 
128 out of every 228 CPU T states (' TV line) ana riunna .y? cut of every 311 TV lines (1 frame)the 
CPU is allowed only 1 access to contended RAM m every 8 T states The CPU is controlled by 
introducing wait states. 

Executing NOP instructions in contended RAM will have an effective average clock frequency of 
2 66MHz (a reduction of about 25 : > j 

I'he Uncommitted Logic Array (Ul.A > handles most;: the 10 such as keyboard tape interface, part of 
the printer interface and screen handling It converts bytes in memory into patter ns and colours on the 
screen and allows the Z80A to scan the keyboard ana read ana write data to tape 

The three-channel sound is produced by ihe AY-3-8912 a very popular sound chip ana this devioe 

inti -'h» RS232/MIDI r.iAUXr o 

-3 the AUX 

:>-iTl -this is to the user - discreti : Th RS232/MIDI pert is rudy support- i fr i +3 BASIC. 

The way m which the AY-3-89! 2 works is quite complex and the would-be experimenter is advised to 
get the manufacturers data sheet The following information should be enough to get things 
underway, however 

The sound chip contains sixteen registers which uie selected by writing first to the address write port 
FFFDh (65533) with the recister number, and then reading ihe register value 'same address) or 
writing tc the data register write address BFFDh (4314&) Once a register has beer, selected any 
number of data toad wnie? can be made the address write port need only be rewritten if a different 
register needs to bo accessed 
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The basic dock frequency of the circuit is i / 34 MH. do 0 0; - 1 , 

Tire registers do the following 

RO - Fine tone control channel A 
Ft I • Coarse tone control channel A 
R2 - Fine tone control channel B 
R3 • Coarse tone control channel B 
R4 - Fme tone control channel C 
R5 - Coarse tone control channel C 

Phe tone of a channel is a 12 bit vaiue taken from the sum of D3-D0 ot the coarse register and D7-D0of 
the the fine register The basic unit of tone is the clock frequency divided by 16 Oe 110.83 KHz) and 
with a 12 bit counter range, frequencies from 27Hz to 110 KHz can be generated 

R6 - Noise generator control, D4-D0 

The period oi the noise source is Taken by counting down the lower 5 bits of the noise register every 
sound clockpenod divided by 16, 

R7 • Mixer and L'Ocontro! 

D7-Not used 
D6-1 means input port 
-0 means output port 
D5 - Channel C noise 
D4 - Channel B noise 
D3-Channel A noise 
D2 - Channel C tone 
D1 - Channel B tone 
DO - Channel A tone 

This register controls both the mixing of noise and tone vames for each channel and the direction n! 
the 8 bit FOport. A zero ma mix bit indicates that the functit - is enabled 

R8 - Amplitude control channel A 
R9 - Amplitude control channel B 
R A - Amplitude control channel C 

D4 • 1 means use envelope generator 

- 0 means use value of D3-D0 for amplitude 
D3-D0 - Amplitude 

These three registers control the amplitude ol each channel and whether or nor ir is inoculated oy the 
envelope registers 

RB Envelope coarse period control 
RC - Envelope fine period conrroI 




The eight bit values in RB+RC are summed to produce a 16 bit number which is counted down in units 
f 256 multiplied by the sound clock Envelope frequencies can be between 0 1 Hz and 6KHz 

RD- Envelope control 

D3- Continue 
D2 - Attack 
PI - Alternate 
DO-Hold 

The diagram of envelope shapes (in part 19 of this chapter) gives a graphic illustration of the possible 
settings for this register 

The disk drive is controlled by the mPD 765A floppy disk controller chip As described in part 23 of 
this chapter, the data register for this device is at address 3FFDh (16301) and the status register is at 
2FFDh (12285) This is a very complex device and it would be unwise to attempt to use it without full 
details of its operation (see the manufacturer s data sheet) 

The Centronics parallel printer port is basically just an 6 bit data latch (74273) whose address is OFTDh 
. 4093). The STROBE signal for the the printer is produced by the ULA and is accessed using bit 4 of 
address IFFDh (8185) The state of the BUSY line from the printer is read from bi> Oof address OFFDh 
(4093) 
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Part 31 
The BASIC 

Subjects covered.- 

Number handling 
Variables 
Strings 
Functions 

Brief summary of keywords 
Mathematical operations 

Numbers are stored to an accuracy of 9 or 1 0 digits The largest number you can get is about ! 0 ' and 
the smallest (positive) nurabens about 4 x 10 

Unless a number represents an exact power of 2 there is a possibility that mathematical inaccuracies 
may become apparent after tepeated addition, subtraction etc This is true of all computers that do 
not use BCD arithmetic Use of integers is suggested if absolute mathematical accuracy is required 

he +3 mfloaongpomt! exponentbyt <=e<= rad 

four mantissa bytes m ( <=m < 1) This represents the number m x 2 1 

Since <=m<l, the most significant bit of the mantissa mis always . Therefore m actus fact we car. 
replace it with a bit to show the sign - 0 fot positive numbers 1 for negative 

Small integers have a special representation m which the first byte is 00h (C 1 the second isa sign byte 
(OOh or FFh) and the third and fourth are the integer itself (in twos 'Complement form) with the least 
significant byte first 

Numeric variables have names of arbitrary length starting with a letter and continuing with tetters 
and digits Spaces are ignored and all letters are converted internally <■ x wet-case letters 

Control variables of FOR NEXT cps have name? • sir.g.e .ette i .■' c. 

Numeric arrays have names a single letter ; ong which may be the same as the rare *f a simple 
variable I'hey may have many dimensions of arbitrary sice Subscript values start .it. 

Strings ate completely flexible in length The name of a string consists c.‘ a single letter to : wed by $ 

String arrays can have many dimensions of,arbitrary size The name is a sin ole alter :• weabyS but 
may nor be the same as the name of a simple string variable Ah ihe sti r . 

th, v rti ' n th DIM 1 npl 

values start at 1 

Slicing substrtr.' is t •: citings may be specified using Sheers A sheer car. be cm T th- toll; wino 

(i) empty 

oi 


(u) a numerical expression 
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or 


(upoptionalnumencalexpression T 0 ptiona! numerical expression 
and is used in expressing a substring by either 
(a) string expression (sheer) 


[■t 


i b) string array variable (subscript, subscript, sheer) 

Which is the same as 

string ai ray variable (subscript subscript) (sheer) 

lr. (a), suppose the string expression has the value s $. then 1 : the sheer is empty, the result is s $ 
(considered as a substring of itself) 

If the siicer is a numerical expression with value m then the result is the mth character of sS (a 
substring of length I) 

If the sheer has the form (ill), then suppose the first numerical expression has the value m (the default 
value is I). and the second n (the default value is the length of s$j If l<=m<=n<=the length f s$ 
then the result is the substring of s S starting with the inth charactei and ending with the nth 

[fO<=n<rr„ then the result is the empty string Otherwise error3resuits 

Slicing is performed before tunctionsor operations are evaluated (unless biackeis dictate otherwise) 

Substrings :ui be assigned to (see LET; Ifastnr.ggunte istn be vvi men in a string literal then it must 
be dcubleu 

Functions 

The argument of a function does ncu need bracKets if it is a constant or variable irptionally 
subset iptea or shcedi 


FUNCTION 

TYPE OF ARGUMENT 

RESULT 

SBP 

number 

Absolute magnitude 


number 

Arccosine m Indians Error A ltx 

m 


nut in the range - +1 
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FUNCTION 


TYPE OF ARGUMENT 


RESULT 


binary operation rigm operand 
always a number 
numeric left operand 

. 4kll . . r $ if b<>o 

a A ND b -1 0 lf b=0 

string left operand 

- Ann J aJ >f b<>0 

a$ AND b -A „„ )f b=(] 


AND has priority 3 

number 

ATcsme in radians Error A if x 
net in the range - . + 

number 

Arctangent in radians 

two arguments xandy,'«th 
numbers (enclosed m bracxets) 

A number whose binary form 
codes the attributes of line x. 
column yon the screen Bit 7 
(most significant) is! forflashing 

0 for steady Bit 6 is 1 for bright C 
for normal Bits 5 3 are the paper 
colour Bits?. C are ink colour 

Err • B ess C <=x<=23and 
0<=v<=j1 

binary number 

This is not ream/ a function, but an 
alternative notation lor numbers 
BIN followed by a sequence of 

Os and Is is the number with such 
a lepresentation in binary 

number 

The character whose cede is x, 
rounded to the nearest integer 

string 

The code of the first character in 
x (or 0 if x is the empty string) 

number (m radians) 

Cosine x 

number 

e* 
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FUNCTION 


TYPE OF ARGUMENT 


RESULT 


FN 

» 

F N followed by a letter calls up a 
user-defined function (see 

D E F ) The arguments must be 
enclosed in brackets - (even if 
there are no arguments, the 
brackets must still be present) 

IN 

number 

The result of mputhng at 
processor level from port x 
(0<=x<=f f FFh) Loads the 8C 
legists' pair with x and does the 
assembly language instruction 
ma,(c) 

INKEYS 

none 

Reads the keyboard The result 
is the character representing the 
key pressed (if there is exactly 
one) else the empty sti mg 

INT 

number 

Integer part (always rounds 
down) 

LEN 

string 

length. 

LN 

number 

Nahrra! logarithm (to base e) 

Error A ifx<=0. 

NOT 

number 

0ifx<>0, lifx=Q NOT has 
priority 4 

OR 

binary operation, 
both operands number • 

„ OR b -T 

|_ a it b=0 

OR haspnorUy2 

PEEK 

number 

The value of the byte in memot y 
whose address is x (rounded ti > 
the nearest integer) Error B tlx 
is noun the range 0 65535. 

PI 

none 

17 (3 141592/. ) 

POINT 

two arguments, xandy. both 
numbers (enclosed m brackets) 

1 if the pixel at (x.yj is ink colour 

0 if it is paper colour 

ErrorBunless '<=x<-255ana 

'j<=y<= ’75_ 
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FUNCTION 

TYPE OF ARGUMENT 

RESULT 

RND 

none 

The next pseudo-random 
number m a sequence 
generated by taking the powers 
of 75 modulo 65537, subtracting i 
and dividing by 65536 Yields a 
number in the range 0 <=:•:< 1 

SCREENS 

two arguments x and y both 

The character that appears 


numbers (enclosed in brackets) 

(either normally or inverted) on 
the screen at linex column y 

Returns the empty string If the 
character tsnot recognised. 

Error B unless 0<=x<=?,3 and 

0< =y<=31 

SGN 

number 

Sign of number Returns -1 fo: 
negative 0 for aero, or + i for 
positive 

SIN 

number (in radians; 

Sine x. 

SQR 

number 

Square tool 

Error A i(x<0 

STRS 

number 

The string o: characters that 
won id be displayed it x were 
printed. 

TAN 

number (in raoians) 

Tangent 

USR 

numbei 

Calls the machine code subroutine 
whose starting address isx On entry 
to the routine at address x the 
memory tsconfigured so that 

OOOCh .3FFfTi(C. 16383) is occupied 
by ROM 3 (46 BASIC) 4000h 7FTFh 
16384 32767) is occupied by R AM 
page 5 80C0h. BFFFh 
(32768 49151) is occupied by RAM 
page 2. and COOOh. FFfTh 



(49152 65535: is occupiea by RAM 
page C If+3L'OS routines are to be 
called RAM page; should be 
switched in at COOCh FFFFh 
>49152 65555 oM2 + DCS 

should be switched in at 

OOOOh, 3FFFh (0 16363) See part 26 
of this chapter for further details 


280 










FUNCTION 


TYPE OF ARGUMENT 


RESULT 


Or. return, the result is the 
contentsof the BC register pan 


US R 


string 


The address of the bit pattern for 

the user-defined graphic 

corresponding to x 

Errct A it x is not a single letter 

between a and u. or a 

user-defined graphic 


VAL 


string 


Evaluates x (without its bounding 
quotes) as a numerical 
expression 

Error C if x contains a syntax 
• -rror or givesa string value 
OtheT errors possible, 
repending or. the expression 


VALS 


Evaluatesx (without itsboundinq 
quotes) as a string expression 
Error C if x contains a syntax 
error or gives a numerical valiu 
Other ei rors possible (as for 
VAL 


numbei 


Negation 


The foil .wving are binary cpere'iv-.:; 

+ Addition (or. numbers), or concatenation (on strings) 
Subtraction 
* Multipuratic: 

/ Division 

Lxf _• -uhr-’i :■ '*rt>'-r B it the left ope! : its negative. 
= Lquai to 

> Greater than 
< Less than 
<= Less than r equal t 

> = Greater than r equal i 
<> Not equal to 


Be in operands must be of the same 
_ tyj 

comparison holds. 0 1 ! it does not 
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Functions and opeiations have the following priorities 


OPERATION 

PRIORITY 

Subscripting and slicing 

12 

All functions except NOT and unary minus 

11 

| (exponentiation) 

10 

- Unary minus (used to negate) 

9 

* / (multiplication, division) 

8 

+ - (addition, subtraction) 

6 

= ><<=>= <> (relational operators) 

5 

NOT 

4 

AND 

3 

OR 

2 


Statements 

The following notation is applicable in the remainder of this section 

i repi esents a single letter 

v represents a variable 

x y.z represent numerical expressions 

m n represent numerical expressions that are rounded to the nearest integer 

e represents an expression 

f represents a string valued expression 

represents* string that eva.uales to a valid drive it- A: B: M : r T : 
u represents an unambiguous DOS filename 

a represents a DOS filename that may be ambiguous, le one that may contain the 

wildcards * or ? 

s represents a sequence of statements separated by colons 

c representsa sequence of colour items, each terminated by commas or semicolons A 
colour item has the form ola PAPER INK FLASH BRIGHT INVERSE or 
OVER statement 

Note that optional expressions are enclosed in [square brackets 

Arbitrary expressions ate allowed everywhere (except for the line number at 'he beginning of a 
statement) 

All statements except INPUT DEF FN and DATA car. be xsed either as commands r u 
programs (although they may be more sensible m one than the other A command or program (me 
can have several statements, separated by ccI .ms There is no restriction on whereabouts in a lire any 
particular statement can occur however see IF mu REM 
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BEEP x,y 


Sounds a note through the TV's speaker for x seconds at 
the pitch y.semitones above middle C (or below middle C 
lfy is negative). 


BORDER t:: 


Sets the bolder colour around the screen, and also the 

paper colour for the lower part of the screen 

E.rror K unlessO<=n:<='/(!e unless mis not in the range 

0.. 7) 


BRIGHT tr 


Sets brightness of characters subsequently printed. 0 tot 
normal. 1 ior bright 8 tor transparent 
Error K unless m is 0.1 or 8 


CAT f#n, |di i -1 


The CAT command produces an alphanumencally 
?srted catalog of files on a disk If used in the form 
CAT # n, the output is directed to stream n If an 
unambiguous filename (or an ambiguous file 
specification) is included then only those files that match 
will be displayed When C A T is followed by a drive letter 
only, then all files on that drive will be displayed I! the 
drive letter specified is T : then a cata log of tape 
filenames will be displayed (together with information 
that will be useful lor tape-to-disk file transfer) 


CAT \U- , |dl [a EXP 


Operates as pci the CAT command but produces an 
expanded catalog that includes system files, arid displays 
those files whose write protection system status and 

MOVE i TO 


CIRCLE x,y,; 
CLEAR 


Draws an arc of a circle. centre (x,y) taaiusz 

Deletes all variables treeing the space they previously 
occupied. 

Executes* RESTORE r i C L S resets the PLOT 
position to the bottom left-hand tiirnei and clears the 
GO SUB stack 


CLEAR 


Like CLEAR but if rssible changes the system 

RAM FOP to n and puts the new GO SUB stack 

there 

(Note that this command may be used ti> ensure the 
machine stack is below BFEOh (49130) when entering a 
routine that calls+3DOS from BASIC ) 


CLOSE It i. 


Marks stream nas being unattached to any channel It 
may then be used in a subseguent OPEN # n ,: 
statement. 


CLS 


(Clear screen) Clears the display fit* 


CONTINUE 


COPY 


COPY EXP 


COPY u TO 
COPY a TO 
COPY d TO 


Continues executing a program from the point at which it 
Slopped with a teport (other than 0) It the report was 9 or 
L. then execution continues with the fo. i wing statement 
(taking any lumps into account) otherwise repeats the 
statement where the report occurred If the last report 
wasm a command line then CONTINUE .vi,.. (tempt to 
continue the command line, and will either go into a loop 
(if the error wastn 0:1) generale repo rt 0 (jf it was m 
0:2 : r- : N ■ ' 0:3 

Sends (dumps) a copy of the top 22 lines of the screen 
display to the printer (if connected t in quad density Epson, 
bn map fc rmat otherwise does nothing 

D BREAK prt 

prematurely stopped the printer maybe eft in graphics 
mode and the line feed set to an odd value 


INVERSE 


u 

d 

d 


Sends a copy of ail 24 lines ot display to the printer (i: 
connected) m quad density Epso n bit map format, 
otherwise does nothing Each coloured dot on the screen 
is printed with a different pixel pattern thus providing 
different grey levels for each c .: ur The BRIGHT 
attribute is also taken into account The optional 
INVERSE modiner aiiows the dump to be reversed 
(like a negative) in order to save nbbon wear when 
prmting-Gut predominantly black dumps 
■ 0 BREAK 

prematurely stopped the primer may be left in graphics 
mode and the line feed set tr an odd value 

Copies the first named file i: the second named file The 
names must be different Drive letters and user numbers 
may be specified within the filename 
If the source (u )tsar. ambiguous file specification then 
the destination (u ) must only t>: a drive letter In this 
case the destination files will have the sane name as the 
source.) 

If both source ana destination names are just drive letters 
a complete drsk-tc-di.sk transfer will tie made (note that 
any files previously on the destination disk ’will be 

t +3 formal 

disk-to■-disk transfer will not work 


When copying files if the destination filename already exists, 
then the rept it F i l e already exists .v.i i. 
dap :v-:f It the rep: rt M i ssing address mark 

isdispsayed then ttslikely that the team at:, n risk ms nut 
beer, formatted 
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COPY u TO SCREENS 

Displays the contents of a disk file on the scieen Control 
characters (tabs, line feeds etc) are replaced by spaces 

This command can only sensibly be used to inspect ASCII 
files (though BASIC programs will be displayed, albeit 
without the correct formatting). 

COPY u TO LPRINT 

The contents of the named disk file are sent to the printer 

No character translations are made. If the command 
FORMAT LPRINT " R " has been issued (tc divert 

RS232 

of the C 0 P Y command rnay be used as a met bod: : 
exporting programs to an external machine 

COPY U TO SPECTRUM 

This allows a +3DOS file header to be added to a binary 

FORMAT 

file created on a different type cf machine A new file with 
the name, u. H E D is created 

DATA e ,e/t- 

Part cr rrj' DATA ist Mi it Pern a program, otherwise 
has no effect 

DEF FN (i , .)=•:• 

User-defined function definition Must be ma program, 
otherwise has no effect Each of 1 and I ,. 1, is either a 
single letter or a single lerter followed by $ tor string 
argument or result 

Takes the form DEF F N 1 () =e if no arguments 

DIM l(n , n.) 

Deletes any array with the name 1. and sets up an at ray 1 oi 
numberswtfhk dimensions n , n 

Initialises all the values to 0 

DIM $(n , ) 

Deletes any array or string with the name 1 $ and sets up 
an array :$ of characters with kdimensionsn , n, 

Initialises ail the values to "" This can be considered as 
an array of strings of fixed length n.. with k-1 dimensions 
(n , rW ) An array is unde fined untii il is dimensioned 
by DI M 

Trior A if there is no room to fit the array in 

DRAW x/y 

DRAW X/V/0 

DRAW x,y,: 

Draws a line from the current plot position moving >: 
horizontally and y vertically relative to it. while turning 
through angle z 

Error B if line tuns off the screen 

ERASE 

If a single file is specified, then that file will be erased from 

ERASE J 

either the default dnve oi the dnve identified m rbe filename 

If an ambiguous file name is specified, a message asking fei 
Yisps 

' ERASE . 11 W . 

byadrive letter only then all files on that drive will be erased 
without confirmation being sought. 
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FLASH 

Defines whether characters will be flashing or steaay. 
n=0for steady, n«) for flasl - • 

FOR )=x TO y 

FOR l=x TO y STEP 1 

FOR ]=x TO v STEP • 

Deletes any simple variable ! and sets up i control 
variable 1 with va:uex limit y stepz. and looping address 
referring to the statement after the FOR statement 

Checks ii the initial value treat t • > = or less (if 
z<0 j than the limit, and if so then skips to statement 

NEXT (error lift next 

Err r 4 if there is no roomier thee ntinlvanabie 

FORMAT d 

Ic in the specified drive (A: or B: j to be 

+3 

message allowing the operation to be abandoned will be 
produced Disks formatted on other machines '.except the 
AMSTRAD PCW range (Cf-2) to i mat ; will not be 
recognised 

FORMAT LINE n 

Sets the- bauarateofthe RS232 interface ton '.'Aid baud 
rates are m the range 75 920C 

FORMAT LPRINT t [;• 

Allows printer output to be redirected and token 
expansion to be switched o n or off I:.string; is" C " • 
subsequent printer output will be via the Centronics 
PRINTER " R " 

.. .. , . . RS232 net 

t car. also be "E" dot expanded! m which case 

■. chr$ 3? : . hi i nnter 

ndfhos : . CHR$ 127 in 
letters o! the appropriate BASIC (■ ken When string! is 
" U " [for unexpended) a!, characters that folk w are sent 
to the pi inter without translatu n This allows ESC i e-scape 

■ " C " I " R " 

string f may be specified this car beoilhet "E" i 
"U" (described above) 

GO SUB n 

PUShe :: ; 1 . GO SUB. I 

g • zk then per ates as per GO TO 

Enor 4r.ay '-rutifth-.-t- ner.rt.v . ..RETURN 

GO TO n 

Jumps to line n ,■ t if there is r ne the first ire after that 

IF x THEN 

Ifx is true (non-zero' then sis executed Note that s 
ct -mprises all the statements until the end of the lira: The 

rn IF-THEN 
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INK n 


Sets the ink (foreground) colour of characters 
subsequently printed, ms in the range 0 7 for a colour 8 
for transparent. 9 for contrast 
Error K uniess0<=n<=9. 


INPUT [#n. 


The isa sequence of INPUT items separated (as in a 
PRINT statement) by commas, semico lons or 
apostrophes. An IN P U T item can be any of the 
following 

U) Any PRINT item not beginning with a letter 
in) A variable name 

(in) LINE, then a string type variable name. 

PRINT itemsandseparai 
exactly asm PR I NT except that everything is 
printed in the lower par! of the screen. For (u) the 
computer stops and waits for input of an expression 
from the keyboard • the value of this is assigned to the 
variable The input is echoed in the usual way and 
syntax errcr Q 

expressions, the input buffer is initialised to contain two 
string quotes (which car. be erased if necessary) If the 
first character STOP SYMB SHIFT 

A then the program stops with errorH (lii)islike(il) 
except that the input is treated as a string literal without 
quotes and the STOP mechanism won’t work, to stop it 
you must press cursor down o instead. 


INVERSE 


LET v=e 


LIST :#n 


Controls inversion of characters subsequently printed It 
rr=C then characters are printed in normal video, le as 
ink colour on paper colour lfr.= . then characters are 
printed m inverse video le paper colour on mkcobui 
Error K unless n=7 or. 

INV VIDEO 

equivalent tc INVERSE 1 pressing the TRUE VIDEO 
<ey is equivalent!: INVERSE 0 

Assigns fho value Of e to the variable v L E T cannot be 
omitted A simple variable is undefined until it is assigned 
• theia LET READ i INPUT tatemer.t 
subscripted string variable or a sliced string variable 
(substring i then the assignment is Procrustean (fixed 
length 1 le the string value of e is either truncated or filled 
out with spaces on the right to rwe n the same It-noth m 
specified in V 

LIST [#m, 0 


287 




Lists the program to the upper part of the screen, starting 
at the first line whose number is at least n. and makes n the 
currentline If# mis included, the output is sent to the 
channel cunently assigned to stream m 

LUST 0 

Like LI ST but using the printer By default, output will 

n - PRINTER 

RS232 

mmand FORMAT LPRINT "R" 

In order that BASIC listings appear correctly token codes 
are expanded to the relevant lettersof each token {codes 
below 32 are not printed) The command FORMAT 
LPRINT "E" can be used to restore this state if it has 
been changed (by FORMAT LPRINT "IT 

Makes the named drive the current aetault input device 
for all subsequent disk operations (COPY,ERASE 
MOVE etc.). If the drive letter specified is T : then ah 
subsequent LOADs will default to tape 

Loads the program and variables from disk (or tape) The 
string! that specifies the hie to be loaded may optionally 
include a dnve letter ana user number when operating 
from disk If a drive letter is not specified, then the default 
drive is used. 

If the string’contains just a r. asterisk. ie LOAD "*" ar 
attempt is made to boot the aisK in drive A This maybe 
used to load alternative oper ating systems or some games 
disks. 

Loads a numeric array :() from filer 

• dei rray $ () ft m 

Loads (ai most) n byres starting at address m 

Loads bytes startmaar address it If a file fr m another 
machine has beer converted to Spectrum formal {usina 
thecommand COPY a TO SPECTRUM 
F 0 R M A T ). then this is the form. 'LOAD :ommand t< 

,use {as the header will not contain a load address) 

Loads bytes back to the address m ::. where they were 
saved 

LOAD I CODE 16384,6912 
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LPRINT 

Like PRINT but using the printer Use the F 0 R M A T 
LPRINT corn.me.nd to direct Output t: the Centronics 

PRINTER RS232 

tokens on or off Bv default, output will be sent to the 

PRINTER socket with tokens expanded and codes below 

32 not printed 1 f ESC (escape.) sequences are to be 
printed (for print formatting), issue the command 

FORMAT LPRINT "U" before using LPRI NT It 

printer output has been set to RS232 (usingthe command 
FORMAT LPRINT "R").then LPRlNTcanbe 

used to send strings of characters to a remote 
computer terminal. 

MERGE 

Like L 0 A D f but does not delete old program lines or 
variables, except to make way for new ones with the same 
line number or name Like LOAD the filename may 
include a drive letter and uset number If a drive letter is 
net specified the default drive will be used 

MOVE f TO ( 

This-will rename me t to? Both files f, and t. must be on 
the same drive 

MOVE u TO f 

The siting f may be " + P" " + S" " + A" "-P" 

"-S"or "-A" This allows the attributes of the file 
specified by u to be set (♦) or unset (-). The attribute 
letters in the string f control write protection (P). system 
status (S or archive status ;A) The C AT EXP 
command can be used to display current settings 

Protected files cannot be erased, saved over, or have any 
operation that would change them m any way performed 
upon them System files are hidden from the normal 
catalog display and at 1 wnbyttu CAT EXP 

command Archive status is provided for compatibility 
with CP M based machines and has no other relevance to 
the + 3 

NEW 

Starts the EASIC system afresh, deleting any program and 
variables, and using the memoty up to and including the 
byte whose address is m the system variable F AMTOP 

The system variables UDG, PRA.MT, RASPand PIPare 
preserved Returns control to the opening menu but does 
not erase files held on drive M (the RAMdisk) 

NEXT 

(l) finds the control variable 1 
(ip Adds its step to its vaiue 

(m) If the step >=C andtheva.jp > the limit or if the step 
<0 and the value < the limit, then tumps to the looping 
statement 

Error 2 if there is no variable 1 

Error 1 lfvanablelaoesnotmatchconttolvanabtem 

FOR statement 
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OPEN #n,f 


OUT m,r 


OVER • 


PAPER n 
PAUSE r. 


PLAY f i,‘ , 


Allows stream number n to be attached to the channel 
identified by string f Stream numbers may be in the range 
0- IS.howeverthesystemitselfmakesuseofO. 3(sctheir 
use is not advised). Possible strings are "S" (for the 
screen channel) " K " (for the keyboard channel) and 
" P " (:: r the printer channel) The printer channel may 

PRINTER 

RS232 \ eke v using the FORMAT L P RIN T 

command. Trying to input fromstream that is set to a 
channel that only support? cutout or vice versa will cause 

an Invalid I/O device tepott 

Outputs byte n at port m at processor :evei 

(Loads the BC reqtstei pair with m. the A register with n 

and executes the assembly language instruction 

out(c), a. 

• :i i 8 Bill < -: < - - ■< = ■.<='■' 

Controls overprinting for characters subsequent:')' 
printed ltn=0 characters obliterate previous characters 
at that position 1?r. = 1 then new characters-ire mixed in 
withc-’.d characters n • give mk colour wherever either (but 

• >» 1> th) had ink colour, and paper • it where they 
were both papet or both mk 

Err i K unlessmsOot . 

Like INK butcr.tr . me th--jp<-r ,b ■ :i: i 

colour 

Stops computing ana displays the display tile tor n frames 
there arc- 50 frames per second :>r until a key is pressed 
1! r.=0 then the pause is not timed but lasts until a key is 
pressed. 

Ftr i B unless'! <=:.<=6o5. ; f 

Interpret up tv outfit strir.es and play then: simu.tar.sously 

The first three strings play via ’ho TV speake t ar.ct 

midi socket 

'•an be output only v: a MIDI 


PLOT 


POKE 


o; n , n Prints an mk dot (sub ect i OVER and INVERSE at 

’hepixe n.r moving rh>: PLOT pesitfc n there! ; 
Umessthe ut itemsrsp* city otherwise themkv lour 
Itthecharacter pr.-jim o::namtr..::lhe: t:« is ;h.<r.geOtr 
the currentpermanent i:v; - .ui and the others.paper 
c-.loar flashing ana rrichtness ate left unchanged 


B < 


/ 


Writes the valuer. 
; rrot B .. < 


- <= : <- 
. . .. 

: <- - 


ath codressn 

<= < = 
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PRINT i#n. 


The is a sequence-:! PR I NT items, separated by 
commas, semicolons or apostiophes. and they are written 
to the display file for output to the screen. 

When used in the form PR I NT Hn, output is 
directed to stream n rathe) than the screen (unless that 
ft n has been oppnect th< screei m " S " i 
A semicolon between two items has no effect - it is used 
purely to delimit the items A comma shifts printing 
forward to the next print zone, while an apostrophe 
generates a carriage return-line feed (which is generated 
by default if a P RI N T statement is not teiminated by a 
semicolon, comma or apostrophe} 

A PR I NT ltemra" be 


(I) Empty, le nothing, 

(«) A numerical expression First a minus sign is printed 
if the value is negative Now let x be the medulusol 
value - (:>:< =. r x > = ' then it is printed using 

scientific nctatic n The mantissa part has up to eight 
digits (with no trailing zeros) ar.d the decimal point 
i absent if only one digit) is after the first The 
exponent part is E followed by + or - followed by 
one or two digits Otherwise x is punted vn ordinary 
decimal notation with up to eight significant digits, 
and no trailing zeros after the decimal point A 
decimal point right at the beginning is always 

e. 03 and 0.3 

are printed as such Zero is printed as a single dtait 

0 


(m) A string expression The tokens in the string are 
expanded possibly with a space before or after 
Control characters have their control effect 
Unrecognised characters print as ? 
i r. A T m,n Outputs an A T conti character 

to -■ wed by a byte for m (the ime number land a byte 
for n (the column number l 
TAB Outputs a tab conti 1 character t.. wed by 
two bytes for r. (least significant byte fust > the lab 


RANDOMI 


stop 

f '-PAPER 

INK FLASH BRIGHT INVERSE rOVER 

statement 

ZE RANDOMIZE 0 
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RANDOMIZE n 

Sets the system variable (called SEED) used to generate 
the next value of R N D If n< > 0 then SEED is given the 
value n If n=0 then SEED is given the value of another 
system variable (called FRAMES) that counts the frames 
so far displayed on the screen, and so should be fairly 
random 

Error B unless ('< =n <=6S535 

READ Vi,v , Vi 

Assigns to the variable using successive expressions m 
the D A T A list 

Error C if an expression is the wrong type 

Error E if there are variables left to be read when the 

DATA list is exhausted 

REM 

No effect The can be any sequence of characters 

ENTER 

R EH ana colons will not be treated 

as separators 

RESTORE 

RESTORE 0 

RESTORE n 

Restores the DATA poir.'er to the hist DATA statement 
in line p. Ifn dcesn t •: :ust (or is. t DATA 
statement: 'hen the first DAT A statement after .men is 
test: is:; -:r :i the next RE AD sta ten er.t will start reacting 
!rom there 

RETURN 

Takes ■r-'iet-ocetoasu-temer.'' GO SLIBstac-' 

and rumps tc the .meaner it 

Error 7 when there is no statement retere.nce on the stack 
- (this pr: r oly means that them is seme mistake in yem 
program - ensure that all GO S U Bs are balanced by 

RETURNS: 

RUN 

RUN 0 

RUN n 

CLEAR mu then GO TO n 

SAVE d 

Makes the named drive the current default. utput device 
for all subsequent disk c perations - COPY ERASE 
MOVEetc If i he drive letter specified is T : thenall 
subsequent S A V Es win default tc tape 

SAVE ( 

Saves the program and variables to disk (or tape), giving it 
the name f The filename may optionally include a drive 
letter and user number when operating with disks. If a 
drive letter is not specified, then the default an ve is used 
Error F if! is empty, or is greater than ten characters in 
length (on tape) 
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SAVE f LINE in 


Saves the program and variables so that if they are loaded, 
there is an automatic jump to line m 

SAVE f DATA 1() Saves the numeric array K ) to the file f. 

SAVE f DATA ISO Saves the character array: ISO to the file f. 

SAVE f CODE m,n Saves n bytes starting at address m 

SAVE ( SCREENS SAVE f CODE 1 6384,691 2 Saves the current 

screen display 

SPECTRUM Switches from +3 BASIC into 48 BASIC, maintaining any 

program m RAM There is no switch back to +3 BASIC 
Note that ROM/RAM switching is not disabled when 
entering 48 BASIC using this command, (this is not the 
case when the option 48 BASICis selected from the 
opening menu). 

STOP Stops the program withreport 9 The CONTINUE 

command will resume the program from the folic wmg 
statement 

VERIFY Like LOAD (from tape), but the tape information is not 

loaded into RAM - instead, it is )ust compared against what 
is already m RAM 

If the filename specifies a disk file (or if the current default 
drive is A or B:), then no action is taken. 

Error R if the comparison shows different bytes. 
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Part 32 

Binary and hexadecimal 

Subjects covered... 

Number systems 
Bits and bytes 

This section describes how computers count, using the binary system 

Most European languages count usings more or less regular pattern m tens m Lncinh. for example, 
although it starts off a bit erratically if soon settles down into regular groups 

twenty, twenty one. twenty two,,, twenty nine 
thirty thirty one, thirty two thirtyr.ine 
forty, forty one, forty two, forty nine 

and so on, and this is made even more systemanc with the numerals mat we use However, the only 
reason for using ten (the decimal system) is that we happen to have ten digits or t nr hands ; fingers 
and thumbs) 

Instead of using the decimal system - based on ten, computers use a form of binary called 
hexadecimal ..or 'hex' for shorn which is based on sixteen. As there are only ten digits available m our 
number system we need six extra digits to do the counting So we use A B C, D, E and F And what 
comes after P Weil, iust as we with ten fingers, write 10 for ten (a hand full), so computers use 10 for 
sixteen Comparing counting in decimal to hex 


DECIMAL HEX 


0 0 

1 1 

2 2 

3 3 

4 4 

5 5 

6 6 

7 7 

8 8 

9 9 

10 A 

11 B 

12 C 

13 D 

14 E 

15 F 

16 10 

17 11 


conlmued. 
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DECIMAL HEX 


25 


19 

26 


IA 

27 

ESC. 

IB 

31 


IF 

32 


20 

33 

etc 

21 

158 


9E 

159 


9F 

160 


AO 

161 

etc 

A1 

255 


FF 

256 

.^nd so on 

100 


If you are using hex notation and you want to make the fact quite plain, then write h at the end ■:! Hit 
number, and say hex’ For instance, for one hundred ana fifty eight (decima. i, write 9Eh and say Time 
Ehex 

You may be wondering what all this has tc dc with computers In fact computers behave as though 
they had only twe digits represented by a tow voltage (or off! known as C. and a high voltage (or on) 
known as 1 This is called the binary system and the two binary digits are called bits so a bit is either 
Oor L 

Sc to expand the previous table of counting tn include binary 


DECIMAL 

HEX 

BINARY 

0 

0 

0 

1 

1 

1 

2 

2 

10 

3 

3 

11 

4 

4 

100 

5 

5 

101 

6 

6 

110 

7 

7 

111 

8 

3 

1000 

9 

9 

1001 

10 

A 

1010 

11 

B 

1011 

12 

C 

1100 

13 

D 

1101 

14 

E 

1110 

15 

F 

1111 

16 

10 

10000 

17 

11 

10001 

...etc... 
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II is customary to pad binary numbers with leading zeros sc. that they always contain at least bur 
bits-forexample.OCOO 000. >' “ ! 0i Urepresentmg0to3decima!) 

Converting between binary r j he:-: is verv easy (use the previous table to help you! 

To convert a binary nu:: >: spin the bit .arv number into qnups of four bits (starting at the right 

of the numberi and cor : r-.:-ch group or tour bus im; it3 corresponding hex digit Finally put the hex 
digits together to form the complete hex numb 0 * f or example, to convert 101 lOiOO binary into hex 
convert the first (right-hand) group d four bits. : )0i t: 4 hex. then convert the next group of lour bus 
()011) to B hex. put them ; -aether and you hav r - the complete hex number - B4h II the binary number 
is longer than eight bus you ra :: minue conver'ino each group of lour bits into one hex digit 1 or 
example. lllOlOllllOOOObinnv: responds to 3 A r T h. 

To convert a hex number to binary, change earn hex digit into four bits (again starting at the tight) 
then put the bits together to form the complete binary numbei Fot example, to convert F3h to binary 
first convert 3 which corresponds to 00! I binary (remember you must use zeros to make the binary 
number four bits' long), then convert F which corresponds to 111! binary, put them together, and you 
have the complete binary number -11110011 

Although computers use a pure binary system, humans often write the numbers stored inside a 
computer using hex notation after all. the number 3AF0h (for example) is far more likely to be easily 
and correctly read than 0011101011110000 in sixteen bit binary notation 

The bits inside the computet are mostly grouped into sets of eight - ihese are called bytes A single 
byte can represent any number from 0 to 255 decimal (11111111 binary or FFh) 

Two bytes can be grouped together to make what is technically called a word A word can be 
expressed using sixteen bits or four hex digits, and represents a number from 0 to 65535 decima. 
(1111111111111111 binary or FFFFh) 

A byte isalways eight bits, but words vary in length from computer to computer 

The BIN notation (used in part 14 of this chapter) provides a means of entering numbers in binary on 
the +3 le BIN 10 represents 4 decima) BIN 111 represents 7 decimal, 
BIN 11111111 represents 255 decimal, and so on 

You can only use 0s and Is for this, so the numbei must be a non-negative whole number - for instance 
you cat not BIN -11- -BIN 

numbei must also be no greater than decimal 65535 ic it can I have more than sixteen bits if you pad 
out a binary number with leading zeros for example BIN 00000001 the BIN function will 
rightly ign< r ■ ‘hem and treat the number as if it were BIN 1 




Part 33 

Example programs 

Programs... 

Renumber 
Clock 
Bustout 
Telly tennis 

Renumber 

This short program is an aid lo the renumbering facility provided by the edit menu's Renumber 
option. If you MERGE this program into the program you are developing (or wish to renumber), you 
will be able to select both the starting line number and the step size {between successive program 
lines) 

Type RUN 9 0 0 0 to run the program enter the start line (in the range ! .9999), enter the step size 
(in the range 1 9999), ihen press the EDIT rey and select the Renumber option from the edit 
menu 

9000 INPUT "Start line",st 
9010 INPUT "Step size",sp 
9020 LET hst= INT (st/256) 

9030 LEI hsp= INT (sp/256) 

9040 POKE 23413,st-256*hst 
9050 POKE 23414,hst 
9060 POKE 23415,sp-256*hsp 
9070 POKE 23416,hsp 
9080 PRINT "Press EDIT then sele 
ct Renumber option" 

Clock 


This program sets up the +3 as an analogue (and digital) doer 

Type RUN to start the program enter the hour (in the range 1 12) and enter the minute (m the range 
0 59) The clock will then start 

10 DIM s(60): DIM c(60) 

20 BORDER 0: PAPER 0: BRIGHT 1 
: INK 7: CLS 

30 PRINT AT 10,1;"Hold on whiL 
e I calculate" 
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40 PRINT AT 11,2;"some sines a 
nd cosines" 

50 GO SUB 370 
60 LET z$="00" 

70 CLS 

80 INPUT "What hour is it ";h 
90 INPUT "How many minutes pas 
t "; m 

100 LET s = 0: POKE 23672,0: POKE 
23673,0 

110 IF h=12 THEN LET h=0 
120 LET Xc = 112 : LET yc = 90: LET 
r = 70: LET rh = r/2: LET rm = r* 
3/4: LET rs=r*5/6 
130 CIRCLE xc,yc,r 
140 INK 1 

150 FOR i=0 TO 359 STEP 30 
160 PLOT (r+1)*s(i/6+1)+xc,(r+1 
)* c(i/6+1)+yc 
170 NEXT i 
180 INK 4 

190 OVER 1: GO SUB 500 
200 GO SUB 470 
210 GO SUB 440 

220 LET tm= INT (C PEEK 23672+2 
56* PEEK 23673)/50) 

230 IF s +1 = tm THEN LET os = s: LE 
T s=s+1: GO TO 250 
240 GO TO 220 

250 IF s=60 THEN LET s=0: POKE 
23672,0: POKE 23673,0: LET 
om=m: LET m=m+1: GO TO 290 
260 PLOT xc,yc: DRAW rs*s(os+1) 
,rs*c(os+1) 

270 GO SUB 440 
280 GO TO 220 

290 IF m=60 THEN LET m=0: LET o 
h = h: LET h = h + 1 : GO TO 330 
300 PLOT xc,yc: DRAW rm*s(om+1) 
,rm*c(om+ 1) 

310 GO SUB 470 

320 GO TO 260 

330 IF h=12 THEN LET h=0 
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340 PLOT xc,yc: DRAW rh*s(oh*5+ 

1),r h*c(oh*5 +1) 

350 GO SUB 500 

360 GO TO 300 

370 PRINT AT 14,0 

380 FOR i=6 TO 360 STEP 6 

390 PRINT 

400 LET s(i/6)= SIN ((i-6)* PI 

/ 180 ) 

410 LET c(i/6)= COS ((i-6)* PI 
/1 80) 

420 NEXT i 
430 RETURN 

440 PLOT xc,yc: DRAW rs*s(s+1), 
rs*c (s + 1) 

450 LET s$= STR$ (s): PRINT OVE 
R 0; AT 18,27; INK 4;":"; I 
NK 6; z$ ( TO 2- LEN (s$));s$ 

460 RETURN 

470 PLOT xc,yc: DRAW rm*s(m+1), 
rm*c(m + 1 ) 

480 LET m$= STR$ (m) : PRINT OVE 
R 0; AT 18,24; INK 2;":"; I 
NK 5;z$( TO 2- LEN (m$));m$ 

490 RETURN 

500 PLOT xc,yc: DRAW rh*s(h*5+1 
),rh*c(h*5 + 1 ) 

510 LET ph= h: IF ph = 0 THEN LET 
ph = 1 2 

520 LET hS= STR$ (ph): PRINT 0V 
ER 0; INK 3; AT 18,22;" "( 

TO 2- LEN (h$));h$ 

530 RETURN 

Bustout 

This program provides a colourful and entertaining iittie game ioi one player against the computer 

I'o play the game type RUN then press any key to start 

Options 

Cursor left 0 moves the bat left. 

Cursor riaht 0 moves the bat right 

The space bar trades a life for a new screen 

See if you can get the highest 'hiscore' 1 
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Note the following when typing in the listing 


1 The "BBBBBBB “s shown in lines 30 and SO are graphics characters I'hey are 
ptoduced by pressing the GRAPH key once (to switch graphics mode on) typing ihe 
characters (using th> B key) then pressing the GRAPH key again (to switch graphics mode 
off) 

2 The " 3 3 3 3 " s shown in line 210 are also graphics characters. Again, they are produced by 
pressing GRAPH nee, pressing the 3 key four tunes, then pressing GRAPH again (Not" that 
these characters will look like black blocks on the screen) 

3 The " A " shown in line 430 is also r graphics character Again, it is produced by pressing 
GRAPH once, pressing the A key once then pressing GRAPH again 


10 BORDER 0: INK 0: PAPER 0: C 
LS : BRIGHT 1 
20 GO SUB 560 

30 LET b$="BBBBBBBBBBBBBBBBBBB 
BB8BBBBBB": REM 28 Bs 
40 LET s$=" 

REM 32 spac 
es 

50 PRINT AT 3,12; INK 7; FLASH 
1;"BUSTOUT"; FLASH 0; AT 6 
,9; INK 1;"B"; INK 7 ;" = 20 
Points"; AT 8,9; INK 4;"B" 
; INK 7;" = 10 Points"; AT 
10,9; INK 2;"B"; INK 7;" = 

5 Points" 

60 PRINT AT 14,1; INK 4;"Press 
SPACE or FIRE to trade"; A 
T 16,3;"a life for a new sh 
eet." 

70 PAUSE 200 
80 LET hiscore=0 
90 LET tscore=0 
100 LET lives=5 
110 LET score=0 
120 C LS 

130 INK 7: PLOT 12,13: DRAW 0,1 
60: DRAW 230,0: DRAW 0,-160 
: INK 0 

140 PRINT AT 1,2; INK 1;b$; AT 
2,2; INK 4;b$ 
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150 FOR r = 5 TO 6: PRINT AT r ,2; 

INK 2;b$: NEXT r 
160 LET bx=9 

170 PRINT AT 19,5; INK 6;"PRESS 
ANY KEY TO START"; AT 17,4 
;"Use < and > to move bat" 
180 PAUSE 0 

190 PRINT AT 19,5; INK 0;s$( TO 
24); AT 20,0;s$ ( TO 32); A 
T 17,4;s$( TO 24) 

200 PRINT AT 21,0; INK 0;s$( TO 
32) : 60 SUB 540: GO TO 220 
210 PRINT AT 20,bx; INK 0;" "; 
INK 5;"3333"; INK 0;" ": RE 
TURN 

220 LET x a = 1: LET ya = 1 ; IF INT 
( RND *2)=1 THEN LET xa=-xa 
230 60 SUB 210 

240 LET x=bx+4: LET y = 11 : DET x 
c = x: LET yc = y 
250 REM main Loop 
260 IF score>1100 THEN GO TO 11 
0 

270 IF INKEYS =" " OR INKEYS =" 
0" THEN IF Lives>1 THEN LET 
Lives=Li ves-1 ; GO TO 110 
280 LET xc=x+xa: LET yc=y+ya 
290 REM scan the keyboard 
300 GO SUB 470 

310 IF yc=20 THEN IF ATTR (yc,x 
c)=69 THEN PLAY "Nig": LET 
ya=-ya: LET yc=yc-2: IF xc- 
bx + 1 OR x c = bx + 4 THEN LET xa 
=-xa: LET xc=x+xa 
320 IF yc = 21 THEN PLAY "03N7#d" 
: PRINT AT y,x;" GO TO 4 
50 

330 GO SUB 470 

340 IF yc = 20 THEN GO TO 430 

350 LET t= ATTR (yc,xc) 

360 IF t = 71 THEN GO TO 410 
370 IF t=64 THEN GO TO 420 
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380 LET ya=-ya: LET xz-xc: LET 
yz=yc: LET yc=yc+ya: GO SUB 
510: IF t=66 THEN PLAY "N1 
e": LET score=score+5: LET 
tscore=tscore+5: GO SUB 540 
: GO TO 350 

390 IF t = 68 THEN PLAY "NIc": LE 
T score=score+10: LET tscor 
e = t s co re +10: GO SUB 540: GO 
TO 350 

400 IF t = 65 THEN PLAY "Nla": LE 
T score = score+ 20 : LET tscor 
e=tscore+20: GO SUB 540: GO 
TO 350 

410 LET xa=-xa: LET xc=xc+2*xa: 
PLAY "Nlf" 

420 IF yc=1 THEN LET ya=1 
430 PRINT AT y,x; INK 0;" AT 
y c , x c; INK 3;"A" : LET x = xc 
: LET y=yc 
440 GO TO 250 

450 LET Lives = lives-1: IF lives 
=0 THEN GO TO 530 
460 GO SUB 540: GO TO 220 
470 LET a$=INKEY$ 

480 IF (a$= CHR$ (8) OR a$="6") 
AND bx>1 THEN LET bx=bx-1: 
GO SUB 210: RETURN 
490 IF (a$= CHR$ (9) OR a$="7") 
AND bx<25 THEN LET bx=bx+1 
: GO SUB 210: RETURN 
500 RETURN 

510 IF yz=20 THEN RETURN 
520 PRINT AT yz,xz; INK 0;" ": 
RETURN 

530 GO SUB 540: PRINT AT 10,10; 
INK 7;"GAME OVER"; AT 12,8 
;"You scored : ";tscore: FO 
R i = 1 TO 300 : NEXT i : GO TO 
90 

540 IF tscore>hiscore THEN LET 
hiscore=tscore 
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550 


560 

570 

580 

590 

600 

610 

620 

630 

640 

650 

660 

670 

680 

690 

700 

710 


PRINT AT 21,11; INK 6; 
ORE ";hiscore; AT 21,1 
RE ";tscore; AT 21,24; 
S ";Lives: RETURN 


FOR 

i = 

US 

R "a" TO 

READ 

b 



POKE 

i 

/b 


NEXT 

i 



RETU 

RN 



REM 

ba 

LL 


DATA 

Li 

,60 

,126,126 

0,0 




REM 

b r 

i c k 


DATA 

B 

IN 

11111111 

DATA 

B 

IN 

10000001 

DATA 

BIN 

10111101 

DATA 

B 

IN 

10111101 

DATA 

B 

IN 

10111101 

DATA 

B 

IN 

10111101 

DATA 

B 

IN 

10000001 

DATA 

B 

IN 

11111111 


"HI SC 
; "SCO 
"LIVE 

"b" + 7 


126,6 


Telly tennis 

i ram sets up the +31 ingotcomputer 

t 'i twoplayets or one player against the computer 

TVp* RUN: an-nt the pro :ran th^n type 1 '2 : lihetu: pet fpiayet •• t i -t 
Options 


A thebatup.Z 

K M 

The first player to score 15 points wins 

fsk 'ip the foil owing when typing in the listing 


The M 66"s shownmar.* n ik iraphtcscharacters They uein bypressinithe 

GRAPH 

GRAPH 

!oo.< like black blnckson the screen 

2 Ihe " 8 "s shown m lines 130.250 and 540 are ai» graphics dwacwra /: t i 
i lu sing GRAPH CAPS SHIFT md press 8 

GRAPH 

blocksenthescreer t 
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3 The " A " shown m line 330 is ala ■ a graphics character Again ll is produced by pressing 
GRAPHont j. pres sing the A'ey • c thenpiessir : GRAPH again 

10 PAPER 4: INK 0: BRIGHT 0: B 
ORDER 4 

20 CLS 

30 GO SUB 730 

40 DIM x C 2 ) : DIM y(2) : DIM p(2 
) 

50 LET compel: LET s c1= 0: LET 
s c2 = 0 : LET z$ — "0 11 

60 PRINT AT 2,9; INK 7;"TELLY 
TENNIS” 

70 PRINT AT 8,3;"ONE OR TWO PL 
AYERS (1/2)?" 

80 LET i$=1NKE Y$ 

90 IF i$="1" THEN PRINT AT 12, 

8;"Use A to go up"; AT 14,8 
;"and Z to go down": GO TO 
120 

100 IF i$ ="2" THEN PRINT AT 10 
,3;"Player 1 use A to go up 
"; AT 12,12;"and Z to go do 
wn"; AT 14,3;"Player 2 use 
K to go up"; AT 16,12;"and 
M to go down": LET comp=0: 

GO TO 120 
110 GO TO 80 

120 FOR i-0 TO 200: NEXT i 
130 LET x(1)=2 : LET y(1> = 3 
140 LET x(2)=29: LET y(2)=18 
150 LET e$ = "8": LET f$ = "66" 

160 PRINT AT 1,0; 

170 GO SUB 400: REM top edge 
180 FOR i=3 TO 19 
190 PRINT AT i,0; INK 6;fS; INK 
0; TAB 30; INK 6;f$ 

200 NEXT i 

210 PRINT AT 20,0; 

220 GO SUB 400: REM bottom edge 
230 PRINT AT 0,0; INK 1;"Player 
1: 00"; AT 0,19; INK 2;"Pl 
ayer 2 : 00" 
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240 LET n= INT ( RND *2) 

250 FOR i = 1 TO 2: PRINT AT y( i ) 
,x(i); INK i;"8"; AT y(i)+1 
,x <i);"8": NEXT i 
260 IF n=0 THEN LET xb=21: LET 
dx = 1: GO TO 280 
270 LET xb=19 : LET dx = -1 
280 LET yb=12 : LET dy= INT ( RN 
D *3)-1 

290 GO SUB 440: REM move bats 
300 LET oxb=xb: LET oyb=yb: LET 
s cd = 0 

310 GO SUB 580: REM move ball 
320 PRINT AT oyb,oxb; INK 0;" " 
330 PRINT AT yb,xb; INK 7;"A" 
340 IF scd = 0 THEN GO TO 290 
350 PRINT AT yb,xb; INK 0;" " 
360 GO SUB 380 
370 GO TO 240 

380 PRINT AT 0,10; INK 1;z$( TO 
2- LEN ( STR$ (sc1)));sc1; 
AT 0,30; INK 2;z$( TO 2- L 
EN ( STR$ (s c2)) );s c2 
390 RETURN 
400 FOR i=1 TO 64 
410 PRINT INK 5;e$; 

420 NEXT i 
430 RETURN 
440 LET a$=INKEYS 
450 IF a$="a" THEN LET p(1)=-1 
460 IF a$ = "z" THEN LET p <1)=2 
470 IF compel THEN LET p(2 ) = < 2 * 
(y(2)<(yb))-(y(2)>(yb))) : G 
0 TO 500 

480 IF a$="k" THEN LET p(2)=-1 
490 IF a$="m" THEN LET p(2)=2 
500 FOR i=1 TO 2 
510 LET a= ATTR (y(i>+p(i),x (i ) 
) 

520 IF p(i) = 2 THEN LET p(i) = 1 
530 IF 3=32 THEN PRINT INK 0; A 
T y(i),x(i);" AT y(i)+1, 
X (i);" LET y(i)=y(i) + p(i 
) 
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540 PRINT AT y(i),x(i ); INK i; 

AT y(i)+1,x(i);"8" 

550 LET p(i)=0 
560 NEXT i 
570 RETURN 

580 LET w = ATTR (yb + dy , xb + dx) 
590 IF w = 32 THEN LET xb=xb+dx: 

LET yb=yb+dy: RETURN 
600 IF w=33 OR w=34 THEN LET dx 
=-dx: PLAY "V1507N1g": LET 
dy= INT ( RND *3)-1: RETURN 
610 IF w=38 THEN GO TO 640 
620 IF w = 3 7 THEN PLAY "V1507N1c 
LET dy=-dy 
630 RETURN 

640 PLAY "03V15#d": IF dx>0 THE 
N LET sc1=sc1+1 : GO TO 660 
650 LET s c2 = sc2 + 1 
660 LET d = (sc1 = 15)-+2*(sc2 = 15) : 
LET scd=1 

670 IF d <> 0 THEN GO SUB 380: 
PRINT INK 7; AT 10,8;"Playe 
r d;" wins."; AT 12,7;"Pl. 
ay again (y/n)?": GO TO 690 
680 RETURN 

690 IF 1NKEY$ ="" THEN GO TO 69 
0 

700 IF INKEYS ="y" THEN RUN 
710 IF INKEYS ="n" THEN STOP 
720 GO TO 690 
730 FOR i= 0 TO 7 
740 READ n 

750 POKE USR "a"+i r n 
760 NEXT i 
770 RETURN 

780 DATA 0,60,126,126,126,126,6 

0,0 
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Chapter 9 

Using the calculator 


Subjects covered... 

Selecting the calculator 
Entering numbers 
Running total 

Using built-in mathematical functions 
Editing the screen 
Assigning variables 
User defined functions 
Exit-ing from the calculator 

The +3 car. be used as a lull function calculator 

To use the calculator, call up the opening menu and select the Calculator option. (If you don't 
know how to select a menu option, refer back to chapter 2.) 

The calculator may be selected assoon as the +3 is switched on Alternatively, if you aie working on 
a +3 BASIC program you may select the calculator by choosing the E x i t option from the edit 
menu (which returns you to the opening menu), at which point you can select the Calculator 
option. Note that any BASIC program which was being worked on (when you selected the calculator) 
will be remembered and restored when you exit from the calculator and return to A3 BASIC 

When you have selected the Calculator option, the screen will change to 



and the +3 3 calculator is ready to accept your first entry Typeir. 
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6 + 4 

As soon as you press ENTER theanswer 10wii: appear (Note that you don't key m = as you would 
on a conventional calculator) 

You will see that the cursor is positioned to right of the answer which is a running total ike on a 
conventional calculator). This means that you can simply type in the next operation to be carried out 
on the running total (without having to type in a whole new calculation) So. with the cursor still 
positioned to the right of the 10 on the screen, typo in 

/ 5 

.and back comes the answer 2 Now type in. 

*PI 


This produces the result 6.2 8 3 1 8 5 3 on the screen. The +3 has used its builr-m,? function -I 
: was type in PI 111 (hi +3 

type in. 


*ATN 60 

which gives the result 9.7648943 . 

demonstrate, move the cursor I using the curs* u left fey ‘ »o the- beginning the line vel then type it 
IN T 90 that the line reads 

INT 9.7648943 

ana as soon as ENTER is pr< seed • mes the answer 9 This also demonstrates that the 
+3 doesn't have to pet forn 
example, press ENTER the:. »yt 

1E6 

.and back will come the valu>. that express- " N tic* that before you typed rr. 1E 6 you pressed 
ENTER on its own this tells tli* +3 that y uar. -l> :lt. ;turf a new cr.lculatt 

the +3 s calculator is that it will allow y 

vanablesand then use them in subsequent caiculati ns let tatei 

ENTER . 

LET X = 1 0 
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(You must then press ENTER twice for the -F3 to accept the variable assignment ) Now verify that 
the variable x is being used, by typing 

x + 90 


..then.. 

+ x*x 

If you are using the calculator whilst working on a BASIC program, then any variables used by the 
calculator should be chosen so that they do not conflict with those used by the program itself 

BASIC keywords are not allowed to be used as variable names. 

When you have finished using the calculator press the EDIT key The screen will change to 



rttheExi t option to return to the opening menu If you were working on a +3 BASIC program 
before you started using the calculator then you may return to the program by selecting the 
+ 3 BASIC tth< Calculator 

option) 

D E F . 

on a BASIC program you will be able to invoke that function when using the calculator Tc illustrate 
this point return +3 BASIC-ndtypein :':r ■:amp.- 

9000 DEF FN c(n)=n*n*n 

which sets up »h- user defined function. FN c (n) whi -h returns the cube fr. (the number you 
type into the br • 3 . t r 

• 3 

FN c(3 ) 


e i tb : st r.vuiprint the number 27 i tt, at- : 
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Chapter 10 

Peripherals for your +3 


Subjects covered... 

Cassette unit 
Printer 

Additional disk drive 
Joystick(s) 

VDU Monitor 
Amplifier 
Serial devices 
MIDI device 
Auxiliary interface 
Expansion devices 

The +3 is capable of operating with a wide range of add-on* [peripherals; such as icystick(s), 
pimiei, cassette unit, etc This section contains all the information necessary to connect these 


Cassette unit 

Programs may be loaded from, or saved to tape instead of tusk (the commands which instruct the 
computer to direct data to and from disk or tape were explained earlier in this manual) 

To connect your cassette unit to the +3 you will require a suitable interconnecting lead wired as 
follows.. 


TAPE/SOUND i.vei r, the +3 


Cassette unit 



To EAR socket 


To MIC socket 
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You will see that the shaft of one of the jack plugs is divided into 3 separate metal sections • this is the 
plug that should he inserted into these cket marked TAPE/SOUND at the back of the +3 

The shafts of the other two jack plugs are divided into only 2 separate metal sections - these are the 
plugs that should be inserted into the sockets on your cassette unit marked MIC and EAR (On most 
commercially available leads the plug for the MIC socket is coloured ted / 

(On some cassette units, the MIC socket may be labelled COMPUTER IN i t INPUT Likewise, th. 
EAR socket may be labelled COMPUTER OUTor OUTPUT) 

It is important to remember 'hat the successful transfer of programs h and from tape is largely 
dependent on the correct setting of the LEVEL or VOLUME control or. your cassette unit If you cannot 
load or save programs easily try experimenting with different LEVEL control positions until the 
optimum setting is found If you cant* ' seem to load or save any programs at all. try reversing the 
plugs to the MIC and EAR sockets on your cassette unit 

Details of tape operation 'will be found it. chapter 4 and chapter 8 parts 20 -.rd 2 7 


Printer 


Chi +3 • v i Hi pat print A would particular 

recommend the AMSTRAD DMP range ;f printers i• j models DMP2C0C DMP3000 DMP3!6Gc t 
1 MP4 -for use with tb<‘ +3 

~3 ding lead 

provided With the printer 

If you wish to use arry other Centrer.icc c mputib.c pimtei you will v guirethe AMSOIT Pi ■ pnntei 
interconnecting lead 

Connect tl> end th* ;> .-a which is fitted with the hat eaue-omr/ ctor plug, intc the socket maiked 
PRINTER i' flu. t : ”1, +3 

Connect th. other • ; i,: the , .,,i which is fitted withaCentrrmc; ;tyii paid pint the socket on the 
printer If your pnnicri is>-guipp>-o with security clips at each sine • itlie *. cket these may be clipped 
mn • the cut-out? at the side of the printer plug 



35 34 33 32 31 30 29 28 27 26 25 24 23 22 21 20 19 


VI. Vi Jd' l- tn.'t 

PRINTER 
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PIN 

FUNCTION 

PIN 

FUNCTION 


STROBE 

!9 

GND 

2 

d: 

20 

GND 

3 

Di 

21 

GND 


D2 

22 

GND < 

s 

D3 

23 

GND 


D4 

24 

GND 


D3 

?.5 

GND 


D6 

26 

GND 


D7 

27 

not used 

K) 

not used 

26 

GND 

1! 

BUSY 

29 

not used 

12 

not useo 

30 

not used 

13 

not used 

31 

not used 

14 

GND 

32 

not used 

15 

not used 

33 

GND 

16 

GND 

34 

not used 

17 

net used 

35 

not used 

■9 

does not exist 

36 

does not exist 


-3 PRINTER 

and IS 15 '.with ir:o 36 n -.-existent : i equivalence .vith the Centronics socrret r. the printer 
itself 

that printers for with t ^3 l rate then feeds internally, youexpenena 
problem: with printer ime feeds try adjusting th^ appropriate DIPswitch inside your printer (On the 
AMSTRA. 3'M.- ■ -- : - ctpnntets DIPswitch 1.3 -'r.-thr inefeeuseitmu 


■ 3 It 

recommended tn-t ir.expener.ced users should rot attempt tc experiment with serial interface 
connections You she u.oi btair a suitable oomputet-tc-sena: printer .ead from your Sinclair dealer, 
.ina you six: ila r.v. -v ■:: 3: \v th-: printer manufacturer smstoUirr. rna jperatscr. instructions 


RS232/MIDI ithf +3 

Details of (? n i tori •. t rmt-or operation wt: bo f.-.una ir. chapter 6 parts 21 and 22 
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Additional disk drive 


The AMSTRAD modi +3 sysi m asan additional disk dnv 

>3 ' ill necessary file maintenance copying, erasing 

etc., on a single disk drive However a second drive will certainly speed up these processes and 
reduce the scope for accidents. 

To connect the FD- 1 to the +3 you will require the AMSOFTDD2 disk inter connecting lead 

Connect the end ot the lead which is tilted with the larger edge-connector plug into the socket 
markeu DISK B: at the back of the -f3 

Connect the other end of the lead which is fitted with a smaller plug into the socket at the- back of thc- 
FD-1 diskdrive 

Important - Before connecting or disconnecting the additional disk dnve make sure that any disc; are 
removed from both drives and that the system is switched off If connections are altered while the 
system is on, it is likely that the system will crash, losing any program or data Always save anv 
valuable programs before meddling with connections' 

When the FD-1 is connected t< if,-: +3 first switch on the FD i (using the slide switch at the back -1 

the disk drive), then switch on the -f 3 (by plugging m the PSU) Both the air 

the front panel of the FD-1 should be illuminated The two-drive system will then be ready to operate 



12 14 16 18 



11 13 15 17 


20 22 



19 21 


24 26 28 30 32 34 



23 25 27 29 31 33 


(viewed from rear, 


DISK B: oel 
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PIN 

FUNCTION 

PIN 

FUNCTION 

1 

READY 


GND 

2 

GND 


MOTOR ON 

3 

SIDE I SELECT 


GND 

4 

GND 


not used 

5 

READ DATA 

22 

GND 

6 

CND I 

23 

DRIVE SELECT! 

7 

WRITE PROTECT 

24 

GND 

8 

GND 

2S 

not used 

9 

TRACK0 

2fi 

GND 

10 

CND 

27 

INDEX 

11 

WRITE GATE 

28 

GND 

12 

GND 

29 

not used 

13 

WRITE DATA 

30 

CND 

14 

CND 

31 

not used 

15 

STEP 

32 

GND 

16 

CND 

33 

not used 

17 

DIRECTION SELECT 

34 

GND 


[>!■-ills nftwo dnveopeiriiion wiii be found in chapter 8 parts 20and 27 


Joystick(s) 


mmend that you use the Sinclair SJS range of toystickfs) with the+3 0thertypi 
lee Atari) will not operate directly as their connectinq plugs are wiied diffeic-r.iiy 

• 3 JOYSTICK 1 

socket 

If a program offers you a choice of loystick types, then choose the Interface Two tot Sinclair) option 
fj It :k circuitry ts designed to work exactly like the Interface r>.\. 

> • r unplug) a loystick while the +9 isswitched on 
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VDU Monitor 

• 3 

of (or in addmcfi Vi ar. rdmary TV If the tr niter that you wish r use .• ' '• . fiftinu 

Spectrum +3 ~ rr.petic.r then the chences are you'!) have to buy a lead for r 
dealer) 

A VI’U ’ ‘ r t'H . 1ir.t ti> RGB/PERITEL : n. 

+3 
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When using a monitor, some provision may have to be made for sound (if required). If the monitor has 
an audio input then then this should be connected either to pm 3 of the RGB/PERITEL socket or to the 
TAPE/SOUND>ckel at the back cf the +3 If the monitor is not capable of producing sound, then an 
external amplifier will have to be used. See the next paragraph for further details. 


Amplifier 

The +3 r.ori: ...y reproduces sound through the TV set it is connected to However, it a VDU monitor 
is being used vr if you would like to record or amplify the sound further, then a sound signal is 
available from th TAPE/SOUND socket at the back of the +3 This is a 3.5mm tack socket 
producing 200m\ pk-pk at approximately 5 Kohms impedance When using an amplifier, it is worth 

. +3, the tape load' and 'save' signals 

at' ;. fed t. th TAPE/SOUND socket and therefore the amplifier's volume control should be 
tunea down when performing these operations). 

Another point tc ... t. :,;;f tth- .eveiof s: und produced by the BEEP command is set to be the same 
n-rh ■ : j.l thi* • PLAYr, r.i: ; at the same Urn. ■ In pr .vtice this meansthat BEEP will 

;;>unci quite • 1 . ,• t»lw PLAY (which may --ause problems if sound levels are critical). 

it u ; < i: •.mpnfier tape recorder -Ac into the TAPE/SOUND socket while 

i +3 . . v if: 


dr ’is— 


Audio output 


T'NDtcomrru \ 


(not used i 



TAPE/SOUND T-'.-t 


-3 
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Serial devices 


• 3 - 3 

your Sinclair dealt- i 

Ifytviwwhi. .vif upy- mown thentht eonrwcttOhsareasfoiinws 


PIN 

FUNCTION 

T 

GND 

? 

IX D 

3 

kXD 

4 

DTP 

5 

Cl'S 

6 

♦ !?.V 


6 5 4 3 2 1 


RS232 i 


Detailsolsen il operation? will U ' 'iind ip chapter 8part2, 


MIDI device 


+ 3 MIDI 

KS232, you will need a different lead for it (available trom your Sinclair dealer) The lead should b* 
connected mt- > the MIDI IN socket on yeur synthesiser drum machine etc There is no provision tor 
'ii +3 ■ receive Ml ldata if can only act as a source No setting up of the MIDI is necessary 
before use (except y ramet rwithmthePLAY ;omi nd total 1 

Using the MIDI interlace will not disturb the RS232'sbaud rate setting 


PIN 

FUNCTION 


RETURN 

? 

not used 

3 

not used 

4 

not ’used 

5 

DATA OUT 

6 

not used 



MIDI 


Details o) MIDI operations will be iound in chapter 8 part 19 
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Auxiliary interface 


The AUX (auxiliary interface) socket supports two input lines (pins 3 and S) and two output lines (pins 
2 and 4), The I/O lines are driven by 1488 and 1489 line driver chips which are, in turn, connected to 
the L'O lines of the AY-3-5912 (see the manufacturer's data sheet for this device) Basically, register 16 
of fhe AY-3-8912 controls eight TO lines; the bits are designated as follows 


BIT 

SIGNAL 

0 

AUX pm2 (out) 

l 

AUX pm 4 (out) 


RS232pir.5(CTSout) 


RS232 pm 3 (RXDout) 


AUXpin3(iu 


AUXpin5(m) 


RS232pm4(DTR in) 

7 

RS232 pin 3 (TXD in) 


Using software control loops, the L'O lines could be driven as a second RS232 port (in the same way as 
th RS232/MIDI socket is driven using bits ?. 3, 6 and /' Alton -lively the L O lines could be used to 
drive, for example, a robot or some other external device 


PIN 

FUNCTION 

J 

GND 

?. 

OUTPUT BIT 0 

3 

INPUT BIT 4 

4 

OUTPUT BIT 1 

5 

INPUT BIT 5 

6 

+ 2V 


6 5 4 3 2 1 


AUX socket 
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Expansion devices 


The +3 can connect to a very wide range o: peripherals via Hie EXPANSION I/O socket a' ti - back 
of the machine. Although this socket is much the same as on the old-style Spectrum 48K there is r.c 
guarantee that a device which rar, correctly on a Spectrum 48K wT! run n a +3 Y . should, 
therefore, before you purchase any expansion device or add on verify that it v\. or,- with the +3 
and not just with a 48K Spectrum. 


WARNING - Ii is very dangerous indeed to plug in (oi unplugi any oevic- tr.r: 
EXPANSION I/O socket whi 1 +3 is switched on - you • 

the +3 and the expansion device if you do so 


U 27 26 26 24 23 22 21 20 19 18 17 16 «b 14 13 12 11 10 9 e 7 6 5 4 3 2 1 

r c ~ Lra nnnnnnnnnnnnnnnnnnnn f—nrin , 

IL-IL-JL-JI—I I —J 1—I l—1 1—f L_J L-J I — 1 I I l I 1 I r 11 I I _I 1_ | | n j LJU LJ 1 

L 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 

EXPANSION I/O socket 


PIN 

UPPER ROW (U) 

LOWER ROW (L) 

sg 

A15 

A14 


A13 

A12 

n 

D7 

+5V 


ROM 1OE 

not used 

H 

DO 

GND 


D1 

GND 


D2 

CK 


D6 

AO 


D5 

A1 


D3 

A2 

n 

12 

D4 

A3 

INT 

not used 

13 

NM1 

GND 

14 

HALT 

ROM 2 OE 










PIN 

UPPER ROW (U) 

LOWER ROW (L) 

15 

MREQ 

D1SKRD 

16 

IORQ 

D1SKWR 

17 

RD 

MOTOR ON 

18 

WR 

BUSRQ 

19 

not used 

RESET 

20 

WAIT 

A7 

21 

+ 12V 

A6 

22 

-12V 

A5 

23 

mT 

A4 

24 

RFSH 

not used 

25 

A8 

BUSACK 

26 

AlO 

A9 

27 

RESET 

All 


Detaiisofthe -f3shardv.'arewillbefoundmchapter8par'5f 


321 

















322 



Index 


A 


C 


Abandoning loading . 

...20 

ABS . 

. 82.277 

ACS . 

. 91 265,277 

Additional disk drive . 

. 17,314 

Aerial lead . 

<3 - 

AFC . 


AFT . 

. 14,15 

Amplifier . 

.134,317 

AMSTRAD computers .... 

. 209,213,217 

AMSTRAD peripherals .. 

.312,314 

AND . 

. 99,278 

Animation . 

.161 

Apostrophe . 

. 58,291 

Archive status files . 

.158 

Argument . 

. 80.26S 

Arithmetic operations . 

. 86,276,281 

Arrays . 

. 95.153.186.265,276 

ASN . 

. 91,265.278 

Assembler . 

. 198,258 

AT . 

... 110,123,175,265,291 

ATN . 

.91,278 

ATT R . 

. 120,122,278 

Attributes. 

.118.151,157.212 

Auxiliary interface. 

.!. 180,319 

AUX socket . 

. 273,319 


B 

Back ups .8,155 

Backspace . 107,121 

BASIC . 5.31.49.276 

Baud rate . 171 

BEEP . 135,283,317 

BIN . 105,278,296 

Binary . 105,294 

Bits . 179,295 

Bootstrap. 203,211 

BORDER . 122,267,283 

Brackets . 79,99,113 

BREAKkey . 14,24.33,53.60,173.266 

BRIGHT . 119,267,283.291 

Brightness.14,16 

Bytes . 153,179,182.296 


Calculator.. 307 

CAPS LOCK key .36,45.50 

CAPS SHIFT key . 36,44,50,103,133 

Cassette operation .21,162,311 

CAT . 39,148,167,268,283 

Centronics . 170,180,312 

Channels. 176 

Characters . 102,118,147,258 

CHR$ . 102,265,278 

CIRCLE . 126,283 

Circles . 88.89,126 

CLEAR . 168.188,198,267,283 

CLOSE . 178,266,283 

CLS . 62,112,283 

C mode .45 

CODE . 102,154,161,166.268,278.288.292 

Colon.„.59 

Colour .14,16,117,291 

Comma .58,106,291 

Commands. 35,49,282 


Compatibility 
Connections 
Contents 
CONTINUE 
Contrast . 


„ 5,209 
10.311 

.1 

58,60,264,284 
.14.16,119 


Control codes characters . 106,115,122,172,258 


Coordinates 

COPY . 

Copying files 

COS . 

CP'M . 

Cursor . 


. 111,124 

158,173,268,284 

. 158,166 

. 90,278 

.146,213,219 

. 18.32.33.48,52 


D 

DATA . 

Decimal . 

DEF . 

Degrees . 

Default drive 
Deleting files .. 
DELETE key .. 
Destination file 


71,153,285,288,292 

.294 

. 83,285,309 

.91 

. 146,149 

.156 

.33,48,52 

.158 
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DIM . 95,265,285 

DISK B: socket ...314 

Disks.8,18,19,36,144,213,220 

Disk drive(s) . 8,19,25,143,160,275,314 

Disk format ... 36,40.144,213 

DOS(+3DOS). . 200.208,223 

DRAW . 125,285 


E 

EDIT key. 

Editing . 

Edit menu.. 

Ejecting a disk. 

E mode. 

ENTER key . 

Epson . 

ERASE . 

Erasing files. 

Error messages . 

Escape code. 

EXP . 

EXPANSION I/O socket 

Exponents. 

EXTEND MODE key . 
External disk drive . 


. 18,32,48,309 

. 33,48,54 

. 18,32 

.29 

...46 

. 17.33,48,52.308 

.170 

. 156.268.285 

.156 

. 39,220,261 

.172 

88,151,173,278,284 

. 181.320 

.75,86 

.46,50 

.17 


H 

Hardware . 170,179.273,319 

Headers .212 

Headphones ..... 134 

Hexadecimal.294 

I 

IF . 62,99,286 

IN . 179,279 

INK . 119,267,287,291 

INKEYS .. 133,176,279 

INPUT . 57.113.176,265.287 

Inserting disks . 19,25 

Installation . 10 

Instructions . 35,49,282 

I NT .. 82,279 

Interface Two.315 

INV VIDEO key .287 

INVERSE . 120,127,174.267.284.287,291 

IO . 179.189 


J 


Joysticks ... 180.315 

JOYSTICK sockets .315 


F 


Fields.38.146 

Filenames .36,38,40.146 

FLASH . 119,122,267,286,291 

FN .83,267,279,309 

FOR . 65,264.286 

FORMAT .38.144 160.171,267 285.286 

Functions . 80.277.308 

G 

G mode .47 

GO SUB . 69,265.286 

GO TO . 57.58.59,265.286 

GRAPH key . 47.51.103 

Graphics . 47.51.103.124 


K 


Keyboard... 48.49,52,180 

Keypad . 208 

Keywords . 35,74,261 

K mode ...44,48 

L 

LEFTS .....85 

LEN . 80,279 

LET . 54.265.287.308 

LINE . 114.153,167,171,267,286,292 

Linefeed . 107,313 

Line numbers . 32,34,54 

LIST . 52.56,265,287 

Listing .33.52.288 

LLIST . 172.265.288 
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L mode........4S 

LN . 88.26S.279 

LOAD . 39,147,151,162,199,266,288 

Loading a BASIC program .39,1S1,162 

Loading software.20,21 

LocoScnpt .213 

Logarithmic function .88 

Logical expressions .99 

Looping „„_ 64 

LPRINT . 170,176,285,289 


M 


Machine code . 

Mams plug . 

Maintenance . 

Mathematical operations 

Memory . 

Menus . 

MERGE . 

M I D$ . 

MIDI . 

MIDI socket. 

Monitor . 

MOVE . 

Music. 


_ 198,258 

.. 10,13,15 

.7 

.. 86,276,281 

. 179,182,222,273 

-16,18 

152,161,166.266,289 

.85 

. 141 181,290,318 

. 273,318 

. 134,316 

. 156,268,289 

.134 


p 


PAPER . 

Parabola . 

PAUSE . 

PEEK . 

Peripherals.. 

PI . 

Pixels. 

PLAY . 

PLOT .. 

. 119,267,290,291 

. 124 

. 130,265,290 

. 105,183,265,279 

. 88,279 

. 111,124 

.... 134,267,290,317,318 
. 124,265,290 

POINT . 

POKE . 

Ports . 

Power indicator lamp .... 

Power supply unit. 

Precautions . 

. 127,279 

. 10S, 183,265,290 

. 170,311 

. 13.15 

.8,9,15,18 

.8 

PRINT . 

Printer . 

PRINTER socket . 

Procrustean assignment 

.54,58,110,176.265,291 
.... 151,168,170,180,312 

. 170,176,312 

.78 

Pseudo-random. 

.92,123 

PSU . 

PSU socket . 

.8,9,15,18 

. 10 

0 


Quotes. 

. 59,76,82 


N 

Nesting . 

NEW . 

NEXT 

.66 

. 57,143,151,289 

65 264 289 

R 

Radians . 

RAM . 

RAMdisk . 

.91 

151,179,182,222,273 
. 143,161 

Noise . 

. 141,274 

RAMTOP . 

. 188 

NOT 

99 279 

RANDOMIZE . 

. 93,265,291 



Random numbers . 

.92 



READ . 

. 71,265,292 



Read write indicator lamp 

. 20,29,38 

o 


Recursion . 

.70 



Relational operators . 

. 63,99,107,281 

OPEN . 


REM . 

. 57,292 

Opening menu ... 

.16 

Renammg files . 

. 156 

OR . 

. 99,279 

Renumbering a program ... 

. 32,56,297 

OUT . 

. 179,290 

Reports . 

39,48,53,57,220,264 

OVER . 

.... 120,127,267,290,291 

RESET button. 

.14,16,20,24 

Overprinting . 

. 119,121,127 

Resetting the computer . 

. 20,24 
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RESTORE . 

. 72.292 

RETURN . 

. 69,265.292 

RGB/PERITELsocket 

.316 

RIGHTS . 

.85 

RND . 

. 92.123,280 

ROM . 

. 179.182.222.273 

Rounding numbers . 

.82,84 

RS232 . 

. 170,180.318 

RS232 socket . 

... 171.176.273.313.318 

R'JN . 

... 39.55.58.59,265,292 


s 


Safety. 

.8,10.18 

SAVE . 

.. 38,146.153,162.266.292 

Saving a program . 

. 38.153,162.199 

Screen display . 

.33.35,48.52,124.154.173 

SCREENS 110.155.160.166,280.285.288.292 

Scrolling . 

.52,58,67,115 

Semicolon . 

. 58,291 

Serial interface . 

. 171.180.318 

Servicing . 

.7 

Settingup . 

.10 

SGN . 

... 82,280 

Sign . 

. 82,280 

SIN . 

. 90.124,280 

Sine wave . 


Slicing. 

. 77,98.276 

Software . 

.5.20,21 

Sound . 

. 134.273.317 

Source file . 


Speakers . 

. 134 

SPECTRUM . 

. 44,160,189,208,285,292 

Spectrum 48 . 


SQR . 


Square root . 

.83 

Stack . 

.69.199 

STEP . 

. 65.286 

STOP . 

. 63.70,'265.292 

Stopping a program ... 

. 57,59.60 

S T R $ . 

.81,280 

Streams . 

. 151.168.176.291 

String expressions. 

. 59.74.76.77.97.276 

Subroutines . 

.69 

Subscript. 

. 95.265 

Substring . 

. 77.276 


Switching on off .. 8.13,18 


SYMB SHIFT key . 33.44.50 

Syntax errox. 48 

System status files . 158 

System variables — . 185.192 

T 

TAB . 112.175,291 

TAN . 91,280 

Tape operation ..21.162,311 

TAPE/SOUND socket 21,134,311,317 

Test signal ....13.15.16 

THEN . 62.99.288 

Timing. 130,273 

TL$ .85 

TO . 65,77.98.156.268.277,284.289 

Tokens . 44.102.106.111.172 

Transparent .. 119 

Trigonometrical functions .86 

Troubleshooting . 15 

TRUE VIDEO key 

Tuning-m TV . 13.15 

TV .. 10.13.120.316 

TV socket.. 10 


u 

ULA . 

Unpacking. 

User area number . 

User defined function 
User defined graphics 
USR . 


.273 

.9 

.146 

. 83,309 

. 51.104.128 

105.199,265.280 


V 


VAL . 

VAL$ . 

. 81.266.281 

. 82.266,281 

Variables . 

.... 55. 74.151.185.265,276.308 

VDU . 

. 134,316 

VERIFY . 

. 165.266.292 

Volume . 

.13,15.312 

w 

Warnings . 

...8.320 

Wildcards . 

. 149.156 

Write protection ... 

.26,40,157 
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X 

X-axis . 90 

X-coordinate .Ill, 124 

Y 

Y-axis . 90 

Y-coordinate .111,124 


z 

Z80 micro processor . 181,189,198,2S8,273 
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